Overview of the BlackBerry push format

Your server-side application can use the BlackBerry push format to send both the data and the delivery parameters to the BlackBerry MDS Connection Service in a single byte stream.

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>/push?DESTINATION=<destination>&PORT=<client_port>&REQUESTURI=<uri>
<headers>
<data>

where

• MDS_CS is the URL address of the BlackBerry MDS Connection Service web server. If you are unsure of the URL, 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.
• destination is the recipient email address, BlackBerry device PIN, or BlackBerry user group name, to whom the BlackBerry MDS Connection Service should push the data. To specify multiple recipient addresses, include a separate DESTINATION parameter for each intended recipient email address or BlackBerry device PIN.
• port is the port number or a string representing the application ID with which your client-side application sets parameters to listen for pushed content. Custom BlackBerry Java Applications should each listen on a unique port.
• uri is the URL sent to the BlackBerry device.
• headers are the HTTP headers that specify the delivery parameters, such as reliability level or delivery time stamp. If you are pushing data to the BlackBerry Browser, you must also include the browser-specific HTTP headers.
• data is a byte stream containing the data or content that the BlackBerry MDS Connection Service must deliver to the recipient BlackBerry devices.