Receiving push result notifications
If you create a push request that specifies either application-level or transport-level reliability, you must also specify a valid notification URL.
The notification URL is the address to which the BlackBerry MDS Connection Service sends result notifications. When the BlackBerry device receives the pushed data, it returns a delivery confirmation message to the BlackBerry MDS Connection Service. The BlackBerry MDS Connection Service forwards the message to the URL provided in the push request. If the BlackBerry MDS Connection Service is unable to deliver the push request, it sends a result notification informing the push originator of the unsuccessful result.
The BlackBerry MDS Connection Service sends all result notifications to the notification URL as an HTTP POST.
If the push request is sent to multiple recipients specified by using multiple email addresses, multiple BlackBerry device PINs or multiple devices using the same email, the BlackBerry MDS Connection Service sends a unique result notification for each recipient.
If the push request is sent to a BlackBerry device user group, the BlackBerry MDS Connection Service sends a single result notification for the entire group. If one member is unable to receive the data, the push request is considered unsuccessful. For example, using the PAP push format, the delivered state means that the message was successfully delivered to all recipients in the group, and the timeout state means that the delivery timed out before all recipients received the message, although some may have received it.
To receive a push result notification
- Using the PAP push format: Specify the notification URL using the ppg-notify-requested-to attribute of the <push-message> element
- Using the BlackBerry push format: Specify the notification URL using the X-Rim-Push_NotifyURL header
Was this information helpful? Send us your comments.