HTTP API - acțiunea 'sendmessage'

Această comandă HTTP API poate fi utilizată pentru a trimite un mesaj SMS prin intermediul Gateway-ului SMS. Comanda poate fi utilizată pentru a trimite mesaje SMS text sau alte tipuri de mesaje, cum ar fi mesaje SMS binare, logo-uri de operator, tonuri de apel, WAP PUSH, etc... Când utilizați această comandă, trebuie să utilizați un nume de utilizator și parolă HTTP API, trebuie să specificați numărul de telefon al destinatarului și textul mesajului.

Pentru a trimite un SMS, utilizați următorul format URL:

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

127.0.0.1 este o adresă IP locală, așa că vă rugăm să o înlocuiți cu adresa IP sau numele de gazdă al computerului pe care este instalat Ozeki SMS Gateway. (Notă: 127.0.0.1 este o adresă de loopback locală care poate fi utilizată atunci când vă conectați la Gateway-ul SMS de pe același computer.) 9508 este portul implicit al HTTP API-ului Ozeki SMS Gateway. Acest număr de port poate fi vizualizat și editat în interfața utilizator a Ozeki 10 SMS Gateway, făcând clic pe butonul Avansat din bara de instrumente.

"UUUUU" și "PPPPP" trebuie înlocuite cu numele de utilizator și parola utilizatorului pe care l-ați creat în gateway-ul SMS.

Înlocuiți "NNNNN" cu numărul de telefon căruia doriți să trimiteți mesajul SMS. Puteți utiliza atât formatul local al numărului de telefon, cât și formatele internaționale de numere de telefon (numerele de telefon formate conform formatului internațional întotdeauna încep cu semnul '+'). Dacă utilizați formatul internațional al numărului de telefon, rețineți că trebuie să înlocuiți '%2B' pentru caracterul '+', din cauza regulilor de codificare URL.

Vă rugăm să înlocuiți "MMMMM" cu tipul mesajului. Tipul de mesaj "SMS:TEXT" ar trebui utilizat pentru mesajele text.

Datele mesajului conțin mesajul pe care doriți să-l trimiteți. Puneți datele mesajului în locul "DDDDD". Datele mesajului ar trebui să utilizeze caractere UTF-8 și să fie codificate URL.

Alți parametri pot fi adăugați la cerere.
Pentru o listă completă a parametrilor disponibili, vă rugăm să consultați tabelul 'Parametrii cererii' de mai jos:

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>Mesaj acceptat pentru livrare</statusmessage>
         <messageid>ERFAV23D</messageid>
         <recipient>06203105366</recipient>
      </acceptreport>
   </data>
</response>

Parametrii cererii HTTP

Parametri de răspuns
(format de răspuns xml)

<acceptreport>
   <statuscode>0</statuscode>
   <statusmessage>Mesaj acceptat pentru livrare</statusmessage>
   <messageid>ERFAV23D</messageid>
   <recipient>06203105366</recipient>
</acceptreport>

Acest articol a fost despre acțiunea HTTP API ‘sendmessage’. Cu această acțiune, puteți trimite mesaje SMS text și multe alte tipuri de mesaje către orice destinatari prin intermediul Ozeki SMS Gateway. Ați văzut exemple de răspunsuri și câteva cereri HTTP suplimentare cu descriere, valori posibile și exemple.

Dacă doriți să aflați mai multe despre starea de livrare a mesajelor dvs., nu ezitați să accesați pagina despre stările de livrare SMS. Dacă doriți să obțineți un șablon de URL, vizitați pagina dedicată.

Dacă doriți să utilizați această soluție în situații reale, descărcați Ozeki SMS Gateway și începeți să-l folosiți acum!