HTTP API — odeslání SMS

Jednoduché odeslání SMS přes GET/POST. API klíč se předává jako parametr (ne hlavička) — ideální pro služby, které umí jen GET/POST bez vlastní hlavičky.

HTTP API je nejjednodušší způsob, jak odeslat SMS — stačí jeden GET nebo POST požadavek. API klíč se předává jako parametr, ne jako hlavička, takže rozhraní funguje i tam, kde platforma umožňuje jen GET/POST a neumí nastavit vlastní HTTP hlavičku.

HTTP API je trvale podporované — jeho podporu neukončujeme. Pro nové integrace, které potřebují více kanálů (Viber/WhatsApp), záložní flow nebo strukturovanou odpověď, doporučujeme JSON API v2.

​

Endpoint

POST  https://http-api-lts.smsmanager.cz
GET   https://http-api-lts.smsmanager.cz

U POST posílejte parametry jako application/x-www-form-urlencoded; u GET jako query string.

​

Parametry

Pro zpěnou kompatibilitu se starší verzí API jsou přípustné také tyto aliasy jednotlivých parametrů (tzn. body nebo message jsou zaměnitelné. Nepoužívejte oboje.).

Parametr	Povinný	Popis
apikey	Ano	Váš API klíč z administrace.
to nebo number	Ano	Telefonní číslo příjemce v mezinárodním formátu; úvodní + je povolen. Více příjemců oddělte středníkem: 420777111222;420777333444.
body nebo message	Ano	Text zprávy.
sender	Ne	Odesílatel (jméno nebo číslo).
gateway	Ne	Typ odesílání (např. high, economy, low, direct).
time	Ne	Naplánované odeslání ve formátu 2025-01-01T23:59:59.
type	Ne	Nastavte utf pro zachování diakritiky.

​

Autentizace

API klíč předejte jako parametr apikey — v query stringu (GET) nebo v těle požadavku (POST). Žádná hlavička není potřeba, což je hlavní výhoda pro integrace bez možnosti upravit hlavičky.

​

Odpověď

Odpověď je text/plain, jeden řádek na příjemce.

Úspěch (HTTP 200):

OK|932125742|420777111222

OK znamená přijato do fronty, následuje message_id a telefonní číslo.

Pokud nastavíte Accept na hodnotu application/json, obdržíte zpět odpověď formátovanou jako JSON:

{
  "result": "OK",
  "id": "932125742",
  "phoneNumbers": ["420777111222"]
}

Chyba:

ERROR|102

​

Příklady

GET

curl "https://http-api-lts.smsmanager.cz?apikey=YOUR_API_KEY&number=%2B420777123456&message=Ahoj%20od%20SmsManageru&sender=MujSender"

curl -X POST https://http-api-lts.smsmanager.cz \
  --data-urlencode "apikey=YOUR_API_KEY" \
  --data-urlencode "number=[phone]" \
  --data-urlencode "message=Ahoj od SmsManageru" \
  --data-urlencode "sender=MujSender"

​

Doručenky

Základní doručovací webhook nastavíte parametrem callback s URL. Pokud potřebujete request formátovat přesně dle cílové platformy (metoda, hlavičky, tělo), použijte objektový callback v JSON API v2.