Odeslání SMS

Endpoint

HTTP Metoda: POST
Adresa endpointu: https://xml-api.smsmanager.cz/Send

HTTP hlavičky

Název	Popis
Content-Type	application/x-www-form-urlencoded

POST Parametry

Parametr	Popis	Povinný
XMLDATA	Toto je název POST parameteru, který ve kterém je nutné zaslat XML řetězec	Ano

XML dokument

<RequestDocument>
  <RequestList>
   <Request Type="high">
    <Message Type="Text">Test</Message>
    <NumbersList>
     <Number>420777123456</Number>
    </NumbersList>
   </Request>
  </RequestList>
</RequestDocument>

Odpověď

HTTP: 200 OK
Content-Type: text/xml
Odpověď se vrací ve formátu XML.

<Result>
  <ResultHeader>
   <Interface Version="1.0" />
  </ResultHeader>
  <Response Type="OK" ID="0" />
  <ResponseRequestList>
   <ResponseRequest>
    <RequestID>550e8400-e29b-41d4-a716-446655440000</RequestID>
   <ResponseNumbersList>
    <Number>420777123456</Number>
   </ResponseNumbersList>
  </ResponseRequest>
  </ResponseRequestList>
</Result>

Pozor

Hodnota RequestID je unikátní identifikátor pro danou zprávu. Dle tohoto ID je možné zprávu identifikovat (dohledat v systému, spárovat doručenku apod.). Momentálně může být hodnotou číslo (int) nebo řetězec (string). V budoucích verzích se bude vracet pouze řetězec v běžném formátu UUID v4.

Info

Pro odpovědi <Response Type="OK" ID="0" /> nelze očekávat, že je zpráva odeslána. Zpráva je v tomto stavu pouze přijata k odeslání a uložena do fronty.