Presence

Presence Service

A service to determine if a device is present on the Sprint cdma network.

Presence Service URL - presence.{format}

http://sprintdevelopersandbox.com/developerSandbox/resources/v1/presence.{format}?{params} 

Authentication

This method requires a generated MD5 signature.

Arguments

• Mdn: The MDN of the device you would like to see the status of.
• key: You're API Key, click here to view.
• timestamp: The current time of the request: [YYYY]-[MM]-[DD]T[HH]:[MM]:[SS][ZZZ]

  [HH] refers to a zero-padded hour between 00 and 23 (where 00 is only used to notate midnight at the start of a calendar day).

• sig: The MD5 Digest value of the parameters of the presence service and your secret. The directions for generating this signature can be found here.

Http Method

Get

Response

• mdn: The mdn of the device checked.
• status: The status of the device.

Example

 

Request

Get:

http://www.sprintdevelopersandbox.com/developerSandbox/resources/v1/presence.txt?mdn=8165553456&key=ABCD123XYZ&timestamp=2009-10-01T12:00:00CDT&sig=123abc456

Response

<response>
<mdn>9132212444$&t;/mdn>
<status>Reachable$&t;/status>
</response>


Errors

• INVALID_KEY The API key sent was invalid.
• EXPIRED_KEY The API key has expired.
• MDN_NOTVALID The MDN requested is not opted in.
• INVALID_MDN Not a valid 10 digit number.
• EXHAUSTED_DIPS Exceeded transaction limit
• Failure
• Error