Troubleshooting guide

225
15: Creating push applications
Create a RIM push request
Task Steps
Push content to one or multiple
BlackBerry® device users using a
RIM push request.
1. To push data to a single BlackBerry device user using RIM push, send an HTTP POST request using
the following URL format:
http://<mdsServer>:<web server listen port>/
push?DESTINATION=<destination>&PORT=<port>&REQUESTURI=<uri><headers><co
ntent>
where:
• <destination> is the destination PIN or email address
• <port> is the destination port number
• <uri> is the URI sent to the BlackBerry device
• <headers> consists of HTTP headers
• <content> is a byte stream
2. To push content to multiple recipients using RIM push, include multiple DESTINATION parameters
in the query string.
http://mds_server:8080/push?DESTINATION=
[e-mail]&DESTINATION=[e-mail]&PORT=7874&REQUESTURI=/
Push content to a group using RIM
push.
> In the recipient addresses portion of the push submission, prefix the group name with the $
character. In the following example, the $ character is URL encoded.
The following example shows a URL used to push to a group named IT using RIM push:
http://mds_server:8080/push?DESTINATION=%24IT&PORT=7874&REQUESTURI=/
Specify a unique message ID to
cancel or check the status of a
message.
>Use the X-RIM-Push-ID header. Typically, specify a URL in combination with a value, such as
[e-mail]. If this header is omitted, the BlackBerry Mobile Data System™ generates a
unique message ID.
Note: Push identifiers must not end in @ppg.rim.com.
Specify a URL to send a result
notification.
>Use the X-RIM-Push-NotifyURL header.
The result notification contains the X-RIM-Push-ID header, which specifies the message ID, and
the
X-RIM-Push-Status header, which specifies an HTTP response code. The notification also
contains an
X-RIM-Push-Destination header that specifies the recipient address to which the
result pertains.
Specify the delivery reliability mode
of the content.
>Use the X-RIM-Push-Reliability-Mode header with one of the following modes:
• application-level (APPLICATION)
• application- preferred (APPLICATION-PREFERRED)
• transport-level (TRANSPORT)
Specify the date and time by which
to deliver the content to the
BlackBerry device.
>Use the X-RIM-Push-Deliver-Before-timestamp header. Content that the application does
not deliver before this date is not delivered. For example:
Mon, 28 Aug 2006 16:06:00 GMT
Specify the date and time after
which the content is delivered to the
BlackBerry device. The application
does not deliver the content before
this date. Represent the date and
time in UTC format.
>In the X-RIM-Push-Deliver-After-timestamp header, specify the date and time in UTC
format. For example:
Mon, 28 Aug 2006 16:06:00 GMT