Phone Emulator

This web emulator phone is designed to return test responses as if the phone was a real phone. Only Presence, Location and SMS APIs responses are simulated through this web interface.

Please note that when the test MDN is used API Keys are not verified, therefore dip will not be deducted when using the emulator phone. If real MDN data is used the transaction will be processed as if utilizing a live device (invoking dip usage) since, well, you will be.

You can also use the test MDN within your real code. Note that in that case, Presence is always on, location is fixed to the same coordinates as displayed below and SMS messages return a success message (but obviously won't be displayed since your device is not the Test MDN device).

What is MDN?

MDN is the industry acronym for Mobile Directory Number. In short, it's the phone number of the Sprint device you want the service to interact with.

If you don't have a Sprint device, simply leave this field blank and the Test MDN will be substituted so that you can continue testing.

What is Key?

Sprint Sandbox Services use the key to identify you and determine what MDNs have opted-in for your application.

If you got here without knowing what a key is, you might want to take a step back and check out the Sandbox Services page.

If you need to locate your key, check out the User Management page. You will need to login to access this information.

What are Geofence Actions?

Geofence actions are used to tell the Geofence API what you are wanting to do. They are summarized below, but for a more in depth overview, please be sure to visit the Geofence specification under Sandbox Services.

Activate
This action activates a geofence.
ID-The fenceId of the geofence to activate.

Add Fence
By far the most complex of the Geofence services, this call adds a new geofence.
Name-The name of the geofence
Start Time-Earliest time to monitor the fence, format [HH][MM].
End Time-Latest time to monitor the fence, format [HH][MM].
Interval-The interval at which the fence should be checked.
Days-Days on which the fence should be monitored, as a String. H=Thurs, A=Sat; i.e. SMTWHFA
Notify Event-Whether the fence should notify on “in”, “out” or “both” (excluding defaults to “both”).
Latitude-The latitude to center the fence on.
Longitude-The longitude to center the fence on.
Dimensions-The radius of the fence.

Add Device
This action adds a device to an existing geofence.
ID-The ID of the geofence (fenceId) to add the device to.
mdn-The MDN of the device to add.

Add Recipient
This action adds a recipient to an existing geofence.
ID-The ID of the geofence (fenceId) to add the device to.
mdn-The MDN or POST URL for the recipient.

Check Perimeter
Create a geofence for one-time use and check to see where device is in relation to it.
mdn-The MDN of the device to check.
Latitude-The latitude to center the fence on.
Longitude-The longitude to center the fence on.
Dimensions-The radius of the fence.

Deactivate
This action deactivates a geofence.
ID-The fenceId of the geofence to activate.

Delete Device
This action deletes a device from a geofence.
ID-The deviceId of the device to delete.

Delete Recipient
This action deletes a recipient from a geofence.
ID-The recipientId of the recipient to delete.

List Fences
This action lists all the fences associated with a device.
ID-The ID of the device (deviceId) to search by.

List Devices
This action lists all devices associated with a geofence.
ID-The ID of the fence (fenceId) whose devices should be returned.

List Recipients
This action lists all recipients associated with a geofence.
ID-The ID of the fence (fenceId) whose recipients should be returned.

What is Secret?

The secret is a "handshake" between you and Sprint to help validate your identity. Unlike the key, it isn't passed as an individual param, but appended at the end of your alphabetized param string before converting it to the MD5 signature.

If you got here without knowing what a secret is, you might want to take a step back and check out the Authentication page.

If you need to locate your secret, check out the User Management page. You will need to login to access this information.

What is Signature?

The signature is an MD5 hash created from the alphabetized service params with the secret appended.

For example, the following service call...
http://sprintdevelopersandbox.com/developerSandbox/ resource/v1/location.txt?mdn=8005554679
&key=ABCD123XYZ&timestamp=2009-10-01T12:00:00CDT
&sig=53d55aae677fc40773719d71c298bbfe

... would create its signature as follows:
sig = MD5("keyABCD123XYZmdn8005554679timestamp
2009-10-01T12:00:00CDTSECRET")

If you got here without knowing what a signature is, you might want to take a step back and check out the Authentication page.

What is Raw Signature?

The raw signature shows you how the params were arranged and the secret appended before conversion to MD5. If your params and secret are configured the same--then converted to MD5--your signature will match what the Sandbox Services expect.

What is Timestamp?

In most modern cultures, the timestamp is utilized as a means of pinpointing a moment in time, such as a specific hour, day or year.

Sprint Sandbox Services don't accept requests more than 15 minutes outside the current time. If they are, you will receive a Request Expired response. Additionally, your device may or may not implode.

Timestamps should conform to the ISO-8601 format. [YYYY]-[MM]-[DD]T[HH]:[MM]:[SS][ZZZ] or
2012-12-12T00:25:58CST

*Note that [HH] refers to a zero-padded hour between 00 and 23 (where 00 is used to notate midnight).