HTTP API - akcia 'sendmessage'

Tento príkaz HTTP API možno použiť na odoslanie SMS správy cez SMS bránu. Príkaz možno použiť na odoslanie textových SMS správ alebo iných typov správ, ako sú binárne SMS správy, logá operátorov, zvonenia, WAP PUSH atď... Pri použití tohto príkazu musíte použiť HTTP API užívateľské meno a heslo, musíte zadať telefónne číslo príjemcu a text správy.

Na odoslanie SMS použite nasledujúci formát URL:

https://127.0.0.1:9508/api?action=sendmessage&username=UUUUU&password=PPPPP&
recipient=NNNNN&messagetype=MMMMM&messagedata=DDDDD

127.0.0.1 je lokálna IP adresa, preto ju nahraďte IP adresou alebo názvom hostiteľa počítača s nainštalovanou Ozeki SMS bránou. (Poznámka: 127.0.0.1 je lokálna loopback adresa, ktorú možno použiť, keď sa pripájate k SMS bráne z toho istého počítača.) 9508 je predvolený port HTTP API Ozeki SMS brány. Toto číslo portu je možné zobraziť a upraviť v používateľskom rozhraní Ozeki 10 SMS brány, kliknutím na tlačidlo Pokročilé na paneli nástrojov.

"UUUUU" a "PPPPP" by mali byť nahradené používateľským menom a heslom užívateľa, ktorého ste vytvorili v SMS bráne.

Nahraďte "NNNNN" telefónnym číslom, na ktoré chcete odoslať SMS správu. Môžete použiť miestny formát telefónneho čísla, ako aj medzinárodný formát telefónnych čísel (telefónne čísla formátované podľa medzinárodného formátu vždy začínajú znakom '+'). Ak sa používa medzinárodný formát telefónneho čísla, uvážte, že znak '+' musíte nahradiť reťazcom '%2B' kvôli pravidlám kódovania URL.

Nahraďte "MMMMM" typom správy. Pre textové správy by sa mal použiť typ správy "SMS:TEXT".

Údaje správy obsahujú správu, ktorú chcete odoslať. Umiestnite údaje správy namiesto "DDDDD". Údaje správy by mali byť písané pomocou UTF-8 znakov a mali by byť URL kódované.

K požiadavke je možné pridať aj ďalšie parametre.
Pre úplný zoznam dostupných parametrov si pozrite tabuľku 'Parametre požiadavky' nižšie:

https://127.0.0.1:9508/api?action=sendmessage&username=admin&password=abc123&
recipient=06203105366&messagetype=SMS:TEXT&messagedata=Hello+World

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 246

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE smsapi PUBLIC "-//OZEKI//DTD XML 1.0//EN" "http://www.ozekisms.com/DTD/smsapi.xml">
<response>
   <action>sendmessage</action>
   <data>
      <acceptreport>
         <statuscode>0</statuscode>
         <statusmessage>Správa prijatá na odoslanie</statusmessage>
         <messageid>ERFAV23D</messageid>
         <recipient>06203105366</recipient>
      </acceptreport>
   </data>
</response>

Parametre HTTP požiadavky

Parametre odpovede
(formát xml odpovede)

<acceptreport>
   <statuscode>0</statuscode>
   <statusmessage>Správa prijatá
   na doručenie</statusmessage>
   <messageid>ERFAV23D</messageid>
   <recipient>06203105366</recipient>
</acceptreport>

Tento článok bol o HTTP API akcii ‘sendmessage’. S touto akciou môžete odosielať textové SMS správy a mnoho ďalších typov správ akýmkoľvek príjemcom cez Ozeki SMS bránu. Videli ste príklady odpovedí a niekoľko ďalších HTTP požiadaviek s popisom, možnými hodnotami a príkladmi.

Ak by ste sa chceli dozvedieť viac o stave doručenia vašich správ, neváhajte kliknúť na stránku o stavoch doručenia SMS. Ak by ste chceli získať URL šablónu, navštívte príslušnú stránku.

Ak by ste chceli použiť toto riešenie v reálnych situáciách, stiahnite si Ozeki SMS bránu a začnite ju používať ešte dnes!