Response

Added by Anders Lindh, last edited by Anders Lindh on Jun 24, 2008
Space Search
Searching Messaging API
Table of Contents

The Roottori SMS gateway will reply with an XML document that describes the result of the submission. In case of missing parameters, a reply with HTTP status code of 400 is returned (the cause can be found in the status text). The returned XML varies depending on whether delivery notifications are requested or not. It has the following DTD: 

<\!ELEMENT delivery-report (acceped, credit-balance?, failed?)>
<\!ELEMENT accepted (recipients, messages)>
<\!ELEMENT recipients (recipient?, #PCDATA)>
<\!ELEMENT recipient (#PCDATA)>
<\!ELEMENT messages (#PCDATA)>
<\!ELEMENT credit-balance (#PCDATA)>
<\!ELEMENT failed (msisdn+)>
<\!ELEMENT msisdn (#PCDATA)>

In the basic scenario (no delivery notifications), the number of recipients and messages and a list of possibly failed recipients is returned. For delivery notifications, each recipient and an associated message id is returned. This message id is passed back to the service provider when the delivery notification is returned (see below). Please see the examples for examples of how the gateway replies. In case of an internal error, a HTTP status code of 500 is returned. In this case the service provider should re-submit the message after a short while.

Labels

 
(None)