SMS cez HTTP
Úvod
HTTP2SMS:
SMS správy môžu byť prenášané prostredníctvom protokolu HTTP. Informácie o našich službách možno nájsť v tomto dokumente.
Požiadavky:
- účet na LacnéSMS.sk,
- dostatočný kredit na odosielanie SMS správ.
Pre viac informácií nás prosím kontaktuje:
- v prípade otázok týkajúcich sa zmlúv a cien: lacnesms@lacnesms.sk,
- v prípade technických otázok: admin@lacnesms.sk.
Technický popis
Adresa pre HTTP2SMS požiadavky
Dáta sú prenášané pomocou HTTP-GET/POST požiadavky. LacnéSMS.sk prijíma požiadavky na nasledujúcej adrese: http://www.lacnesms.sk/send/alebo SSL verzia
https://www.lacnesms.sk/sendssl/
Parametre pre HTTP2SMS požiadavky
Povinné:username:
Email, ktorý bol použitý pri registrácii do LacnéSMS.sk.
password:
Heslo, ktoré použite pre prístup do LacnéSMS.sk.
from:
Ide o číslo, virtuálne číslo, alebo nick, ktoré môžete používať pre odoslanie sms na portály LacnéSMS.sk (pozn.: pre našich top partnerov umožňujeme tento parameter zadať ľubovoľne, inak sa tento parameter kontroluje voči LacnéSMS.sk).
to:
Numerický medzinárodný formát čísel, na ktoré chcete odoslať SMS. Ak chcete odoslať SMS pre viac čísel, oddeľte čísla čiarkou (maximálne však môžete odoslať 1 SMS na 10 čísel v jednej požiadavke).
text:
Text správy, ktorá sa má odoslať.
Nepovinné
utf:
Či má byť sms odoslaná v utf - 1, alebo v kódovaní GSM – 0. Ak použijete 0 text nemusíte kódovať do GSM, toto kódovanie prebieha na strane servera LacnéSMS.sk. Predvolené nastavenie je 0.
delivery:
Či má byť na odoslanú SMS vrátená správa o doručení. 0 – nie, 1 – áno. Je potrebné si v svojom konte nastaviť adresu pre callback. Na danú adresu sa posiela POST požiadavka s parametrom „result“ a odpoveďou v tvare CODE|xxx:yyy (popis uvedený nižšie). V jednej požiadavke môžu byť aj viacero odpovedí na SMSky, pričom jednotlivé odpovede na SMS sú oddelené medzerou. Callback na Vami zadanú url je zasielaný až kým nedosiahne HTTP CODE 200, alebo neprejde viac ako 24 hodín od odoslania SMS. Predvolené nastavenie je 0.
flash:
Či sa má sms odoslať ako flash - 1, alebo ako sms – 0. Predvolené nastavenie je 0.
Pozn.: Nezabudnite pri odosielaní SMS na maximálnu veľkosť povolených znakov v jednej SMS.
SMS bez špeciálnych znakov - GSM:
1 SMS - max 160 znakov
2 SMS - max 306 znakov
3 SMS - max 459 znakov
SMS so špeciálnymi znakmi (diakritika, interpunkčné znamienka) - UTF:
1 SMS - max 70 znakov
2 SMS - max 134 znakov
3 SMS - max 201 znakov
Flash SMS:
gsm – 160 znakov
utf – 70 znakov
Príklad:
http://www.lacnesms.sk/send/?username=email&password=heslo&from=421905xxxxxx&to=421905xxxxxx,421905xxxxxx&text=text&utf=1&flash=1&delivery=1
https://www.lacnesms.sk/sendssl/?username=email&password=heslo&from=421905xxxxxx&to=421905xxxxxx,421905xxxxxx&text=text&utf=1&flash=1&delivery=1
Odpoveď servera:
Odpoveď sa skladá z 2 častí:- HTTP hlavičky - stavový kód
- HTTP obsah - obsahujúci textový reťazec
Možné stavy:
HTTP CODE 200 - uspešné, t.j. parametre boli zadané správne, sms prešla na bránu – obsah textu uvedený nižšie.
HTTP CODE 400 - chýbajúce povinné parametre: username, password, from, to, text – text ERR UNAUTHORIZED.
HTTP CODE 401 - chyba prihlásenia – text ERR BAD_REQUEST.
Ak dostanete odpoveď od servera v HTTP hlavičke 200, znamená to, že ste uviedli správne parametre SMS, Vaša SMS prešla na SMS bránu a odpoveď servera bude v tvare:
CODE|xxx:yyy:ccc
Pričom: CODE uvádza do akého stavu sa dostala SMS, xxx je Vaše zadané mobilné číslo (kam sa odosiela sms), yyy je pridelené číslo SMS branou (pomocou tohto čísla môžete ďalej sledovať stav SMS), ccc je cena SMS s DPH (ak SMS je v sate 1000 jej cena bude 0 a po odoslani sa zmeni).
CODE môže nadobúdať tieto hodnoty:
200 - úspešne odoslaná na sms bránu - len v tomto prípade bude odrátané z kreditu
400 - chyba dĺžky textu (dĺžka sms prekročila počet povolených znakov)
404 - chybné mobilné číslo, alebo nepodporované našim systémom
402 - nedostatočný kredit
503 - nastala vnútorná chyba pri odoslaní sms
V prípade ak bol pri odosielaní SMS pridelený kód 200 alebo 1000, jej stav sa bude neskôr meniť, t.j. Môže sa dostať do týchto stavov (stav si môžete overiť vo Vašom administračnom rozhraní, alebo cez HTTP):
1 - doručená
2 - čaká na doručenie - správa nebola prvý krát doručená a čaká sa na opätovné doručenie.
3 - správa nebola doručená (napr. z dôvodu, že zadané mobilné číslo je odpojené)
5 - platnosť doručenia vyexpirovala - SMS vyexpirovaná po 24 hodinách neúspešného doručenia
6 - zamietnutá SMS centrom
7 - chyba pri odoslaní
11 - neznáma chyba - neznámy status, väčšinou ak po 24 hodinách SMSC nenahlásilo konkrétnu chybu
12 - neznáma chyba - neznámy status, SMSC nevrátilo žiaden status
1000 - sms čaká na odoslanie - ako hromadná sms
SMS brána sa snaží 24 hod. Doručiť SMS (napr. ak je mobilné číslo vypnuté), ak sa mu to však v tomto čase nepodarí, SMS zahadzuje.
Knižnica na stiahnutie
PHP knižnica na odosielanie SMS pomocou HTTP