Server-side: consumer apps

The server-side push initiator, or Push Initiator, is an app that creates request messages (push request, cancel request, and status-query request) and response messages (result-notification response) using the server-side library of the Push Service SDK, and then submits them to the Push Proxy Gateway (PPG). The server-side push initiator sends a push message to the BlackBerry Internet Service (BIS) in the form of an HTTPS POST. The server-side push initiator also uses the server-side library to process subscription-related requests (subscribe, unsubscribe, suspend, and resume) that it receives from the push-enabled app on the BlackBerry device.

The push message is a MIME multipart message, which contains the following items:

  • A Wireless Application Protocol (WAP) Push Access Protocol (PAP) version 2.1 XML control entity, which describes the delivery parameters and specifies one or more BlackBerry devices that the content is delivered to
  • The content to deliver to the specified devices

To develop a server-side push initiator, you implement the following general steps:

  1. Convert the push message to the correct PAP message. For more information, see Creating a PAP push message.
  2. Add the authorization headers to the message. For more information, see Adding an authorization header to the push request.
  3. Submit an HTTPS POST request to the PPG using the information that you received from BlackBerry when you registered for the Push Service. For more information, see Submitting a PAP push request.

Last modified: 2015-07-24

Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus