Share via

WAP Push Message Format

  • Article

Windows Mobile™-based Smartphone and Windows Mobile™-based Pocket PC process the push headers shown in the following table.

Push header Description
Content-Type A required header that is implemented as defined in HTTP/1.1.
Content-Location A header that is implemented as defined in HTTP/1.1.
Push-Flag A bit mask flag that indicates if the initiator Uniform Resource Identifier (URI) is authenticated and the content is trusted. This flag is implemented as defined in the WAP-189-PushOTA Version 17-Feb-2000 specification.
X-WAP-Application-ID A generic header that provides an application identifier (ID). This header is implemented as defined in the WAP-189-PushOTA Version 17-Feb-2000 specification.
X-WAP-Content-URI A generic header that is used in caching to identify the URI of the HTTP request.
X-WAP-Initiator-URI A generic header that identifies the WAP push initiator.
X-MS-DESC A custom header designed to provide a brief description of the purpose of the push message.

The following is a WAP push message that can be processed by the Push Router. This example message identifies Configuration Manager as the application that processes the push body. In the header, the content type is identified as a WAP connectivity document.

Note   For this example, if an application ID is not provided, but the content type is one that is defined in the WAP Provisioning Content Specification, the message will also be routed to Configuration Manager.

The push message also identifies that the Uniform Resource Locator (URL) of the push initiator is https://www.thephone-company.com. The push body is a provisioning XML document that is used to update two locale settings. The headers and body are not compressed.

Headers Example

X-WAP-Application-Id: x-wap-microsoft:cfgmgr.ua
X-WAP-Initiator-URI: https://www.adatum.com
Content-Type: text/vnd.wap.connectivity-xml
X-MS-DESC: Update Locale settings

XML Code Example

<?xml version="1.0"?>
<wap-provisioningdoc>
   <characteristic type= "Locale">
      <parm name= "LOCALE_SCURRENCY" value="$"/>
      <parm name= "LOCALE_SDECIMAL" value="."/>
   </characteristic>
</wap-provisioningdoc>

See Also

Push Router | WAP Push OTA Protocol Features | WAP Push Headers

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.