Overview of the PAP push format
Your server-side application can use the PAP push format to send three types of requests to the BlackBerry MDS Connection Service:
- Push request: This request allows you to push data to the specified recipients. A PAP push request is a MIME multipart message which contains a PAP control entity that defines the delivery parameters, and the data to be pushed.
- Status-query request: This request allows you to query the status of a push request for one or more specified recipients. A PAP status-query request includes an XML-based PAP control entity, which identifies the associated push request, and lists the recipient addresses for which the push request status should be queried.
- Cancellation request: This request allows you to cancel a push request for one or more specified recipients. A PAP cancellation request includes an XML-based PAP control entity, which identifies the associated push request, and lists the recipient addresses for which the push request should be cancelled.
In each case, you send the request as an HTTP POST request to the BlackBerry MDS Connection Service. If the BlackBerry MDS Connection Service is configured to support secure connections, you can use the HTTPS protocol. The HTTP POST request must use the following format:
POST http://<MDS_CS>:<MDS_CS_port>/pap <message>
where
- <MDS_CS> is the URL address of the BlackBerry MDS Connection Service web server. If you are unsure of the URL address of the BlackBerry MDS Connection Service, contact your BlackBerry Device Service Administrator.
- <MDS_CS_port> is the port number on which the BlackBerry MDS Connection Service web server listens. By default, the BlackBerry MDS Connection Service listens on port number is 8080. If you are unsure of the port number, contact your BlackBerry Device Service administrator.
- <message> is either a multipart message with the PAP control entity and the data (in the case of push requests), or a PAP control entity on its own (in the case of status-query and cancellation requests).
Was this information helpful? Send us your comments.