Odeslání SMS
Endpoint
HTTP Metoda: POST nebo GET
Adresa endpointu: https://http-api.smsmanager.cz/Send
Doporučujeme
Doporučujeme používat POST metodu.
HTTP hlavičky
| Název | Popis |
|---|---|
| Content-Type | application/x-www-form-urlencoded |
POST / GET Parametry
| Parametr | Popis | Povinný |
|---|---|---|
apikey | API klíč, který lze získat z administrace | Ano |
number | Telefonní číslo Příklad: 420777111222 | Ano |
message | Text zprávy | Ano |
sender | Odesílatel | Ne |
gateway | Typ odesílání | Ne |
time | Datum a čas odeslání zprávy. Příklad: 2025-01-01T23:59:59 | Ne |
type | Nastavení typu zprávy Pro zachování diakritiky v SMS použijte hodnotu: utf | Ne |
Odpověď
HTTP: 200 OK
Content-Type: text/plain
Odpověď se vrací v textovém formátu.
OK|550e8400-e29b-41d4-a716-446655440000|420777111222
| Hodnota | Popis |
|---|---|
OK | Zpráva byla úspěšně přijata k odeslání a uložena do fronty |
550e8400-e29b-41d4-a716-446655440000 | ID zprávy |
420777111222 | Telefonní číslo |
Pozor
ID zprávy 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
Po odpovědi OK 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.
Chyba
HTTP: 200 OK
Content-Type: text/plain
Odpověď se vrací v textovém formátu.
ERROR|102
| Hodnota | Popis |
|---|---|
ERROR | Zpráva nebyla odeslána |
102 | Číslo chyby |