HTTP API - 'sendmessage' művelet

Ez a http api parancs SMS üzenetek küldésére használható az SMS Gateway-en keresztül. A parancs szöveges SMS üzenetek vagy más típusú üzenetek küldésére is használható, például bináris SMS üzenetek, operátor logók, csengőhangok, WAP PUSH stb... A parancs használatához egy http api felhasználónév és jelszó szükséges, valamint meg kell adni a címzett telefonszámot és az üzenet szövegét.

Leírás

SMS küldéséhez használja a következő URL formátumot:

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

A 127.0.0.1 egy helyi IP cím, ezért kérjük, cserélje le az Ozeki SMS Gateway telepítését tartalmazó számítógép IP címére vagy hosztnevére. (Megjegyzés: a 127.0.0.1 egy helyi loopback cím, amely akkor használható, ha ugyanarról a számítógépről csatlakozik az SMS Gateway-hez.) 9508 az Ozeki SMS Gateway HTTP API alapértelmezett portja. Ez a portszám megtekinthető és módosítható az Ozeki 10 SMS Gateway felhasználói felületén, az Eszköztárban lévő Advanced gombra kattintva.

Az "UUUUU" és "PPPPP" helyére az SMS gatewayben létrehozott felhasználónév és jelszó kerüljön.

Az "NNNNN" helyére a címzett telefonszáma kerüljön, amelyre az SMS üzenetet küldeni szeretné. Használhat helyi telefonszámformátumot, valamint nemzetközi telefonszámformátumot is (a nemzetközi formátumban megadott telefonszámok mindig '+' jellel kezdődnek). Ha nemzetközi telefonszámformátumot használ, figyeljen arra, hogy a '+' karakter helyett '%2B'-t kell használni az URL kódolási szabályok miatt.

Az "MMMMM" helyére az üzenet típusa kerüljön. A "SMS:TEXT" üzenettípus használható szöveges üzenetekhez.

Az üzenet adata tartalmazza a küldendő üzenetet. Az üzenet adatot helyezze a "DDDDD" helyére. Az üzenet adatnak UTF-8 karakterkészletet kell használnia, és URL kódoltnak kell lennie.

További paraméterek is hozzáadhatók a kéréshez.
A rendelkezésre álló paraméterek teljes listáját az alábbi 'Kérés paraméterei' táblázatban találja:

Példa URL kérés

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

Példa válasz

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>Message accepted for delivery</statusmessage>
         <messageid>ERFAV23D</messageid>
         <recipient>06203105366</recipient>
      </acceptreport>
   </data>
</response>

HTTP kérés paraméterei

Válasz paraméterek
(xml válasz formátum)

<acceptreport>
   <statuscode>0</statuscode>
   <statusmessage>Message accepted
   for delivery</statusmessage>
   <messageid>ERFAV23D</messageid>
   <recipient>06203105366</recipient>
</acceptreport>

Összefoglalás

Ez a cikk a HTTP API ‘sendmessage’ műveletről szólt. Ezzel a művelettel szöveges SMS üzeneteket és sok más típusú üzenetet küldhet bármilyen címzetthez az Ozeki SMS Gateway-en keresztül. Láttunk példa válaszokat és néhány további http kérést leírással, lehetséges értékekkel és példákkal.

Ha többet szeretne megtudni az üzenetei kézbesítési állapotáról, kattintson az SMS kézbesítési állapotokról szóló oldalra. Ha egy URL sablont szeretne kapni, látogasson el a hozzá tartozó oldalra.

Ha valós helyzetekben szeretné használni ezt a megoldást, töltse le az Ozeki SMS Gateway-t és kezdje el használni most!