SBD Relaying

To easily transmit messages from your application to the Iridium network, we have created a simple to use API mechanism to communicate directly with the Iridium gateway, and receive back instantaneous information to your application on the message queue status at the ground station. Otherwise, to communicate directly with the Iridium ground station, you will need to develop a binary parser and submit a static IP address to us for whitelisting at Iridium, which takes 2-3 weeks to perform.

Iridium SBD relay requests are sending using an HTTP POST to the URL format: https://{Domain}/Services/IridiumSBDRelay.ashx

These HTTP POSTs must include the following fields:

Parameter Name Type Description
key SBD Key String The SBD Key that was setup for the customer. This identifies the customer making the request.
imei IMEI String The IMEI of the device to receive the SBD message.
messageid Message Identifier Integer The unique message identifier to associate with the SBD message. This identifier should be unique across your SBD messages.
message Message String (Base 64 encoded) The binary SBD message you wish to send as a base-64 encoded string.

Successful submissions will return an HTTP status of 200 and include debugging information text.

Submissions that error will return a non-HTTP status of 200 and provide text describing the error, such as which input parameters are missing.

Sample Submission Form

<form action="https://www.domain.com/Services/IridiumSBDRelay.ashx" method="post">
<fieldset>
<div><label for="key">Client key:</label></div>
<div><input type="text" id="key" name="key" /></div>
<div><label for="messageid">Message Id:</label></div>
<div><input type="text" id="messageid" name="messageid" /></div>
<div><label for="imei">IMEI:</label></div>
<div><input type="text" id="imei" name="imei" /></div>
<div><label for="message">Message (base64 string):</label></div>
<div><textarea id="message" name="message" rows="5" cols="30"></textarea></div>
<button>Submit Message</button>
</fieldset>
</form>