Návratové kódy HTTP/XML rozhraní

Dle uvedených návratových kódů můžete kontrolovat stav jednotlivých požadavků.

Číselníky pro jednotlivé stavy

Průběh odesílání SMS

Kód Význam Finální stav
0
Požadavek čeká na odeslání Ne
1
Požadavek se odesílá Ne
2
Požadavek byl odeslán Ano
3
Požadavek byl částečně odeslán Ne
4
Neodesílatelný (neplatná data u požadavku, neplatná telefonní čísla apod.) Ano
5
Požadavek nelze odeslat, odesílání bude opakováno Ne
6
Požadavek na odeslání zrušen uživatelem Ano
7
Požadavek na odeslání zrušen systémem (vypršela platnost zprávy a zpráva nebyla odeslána) Ano
9
Požadavek na odeslání je zpracováván Ne

Doručenky

Kód Význam Finální stav
0
Ke zprávě není doručenka Ne
1
Zpráva se doručuje Ne
2
Zpráva doručena Ano
3
Zprávu se nepodařilo doručit Ano
4
Stav zprávy není jistý Ne
5
Zpráva čeká na doručení (plná paměť telefonu, vypnutý telefon apod.) Ne
6
Zpráva nebyla do vypršení plantosti doručena (zpráva expirovala, vypnutý telefon, číslo se nacházelo v roamingu apod.) Ano
7
Zpráva nebyla doručena z důvodu neplatného telefonního čísla Ano
8
Zpráva nebyla doručena, kontaktujte nás pro více podrobností Ano

Chybové stavy

Prakticky každá odpověď z našeho API je opatřena číslem kódem chyby, který pomůže rozpoznat důvod proč nebyl požadavek zpracován. V opačném případě je HTTP status kód "200 OK". Chyby 1xx-2xx (HTTP status kód 4xx) souvisí s neplatným požadavkem ze strany klienta a nemá smysl jej opakovat se stejnými daty. Chyby 9xx souvisí s chybou na serveru a pravděpodobně je lze řešit opakovaným zasláním stejného požadavku.

Většina požadavků je vyřízena v čase pod 1 vteřinu. Doporučujeme nastavit timeout na 30 vteřin. Po 30 vteřinách server odpovídá chybou "503 Service Unavailable". Takový požadavek nebude vyřízen.

Kód HTTP status kód Význam Opakovat?
101
400
Neexistující data požadavku (chybí XMLDATA parametr u XML API) Ne
102
400
Zaslaná data nejsou ve správném formátu Ne
103
401
Neplatné uživatelské jméno nebo heslo Ne
104
400
Neplatný parametr
gateway
Ne
105
402
Nedostatek kreditu pro
prepaid
Ne
109
400
Požadavek neobsahuje všechna vyžadovaná data Ne
201
400
Žádná platná telefonní čísla v požadavku Ne
202
400
Text zprávy neexistuje nebo je příliš dlouhý Ne
203
400
Neplatný parametr
sender
(odesílatele nejprve nastavte ve webovém rozhraní)
Ne
9xx
500
Systémová chyba (informujte se na support@smsmanager.cz) Ano
 
503
Požadavek nemohl být přijat z důvodu chyby na serveru Ano

Pokud chcete využít napojení na existující služby, prohlédněte si dokumentaci.
API dokumentace

U nás lze vše realizovat online. Včetně plateb. Podporujeme platební karty VISA, MasterCard a systém PayPal. Máme účet u Raiffeisenbank pro rychlé obdržení Vaší platby. VISA MasterCard PayPal