SMS Gateway paraméterek
Itt találod a SeeMe SMS Gateway során használható paraméterek teljes listáját.
Paraméter | Típus | Kötelező | Érték |
---|---|---|---|
key | String | IGEN | Az authentikációhoz szükséges API kulcs. Ha még nem rendelkezünk vele, itt tudunk generálni: SMS Gateway beállítások |
message | String | IGEN | Küldendő üzenet szövege UTF-8 kódolásban! |
number | Int | IGEN | A címzett telefonszáma nemzetközi formátumban |
sender | String | nem | Feladóazonosító |
callback | String | nem | Azon státuszok kódjai vesszővel elválasztva, melyekről callback hívás formájában visszajelzést szeretnénk kérni |
callbackurl | String | nem | Az internet felől publikusan elérhető URL amelyre a callback hívást szeretnénk kérni. Üzenetenként eltérő lehet. Csak az adott üzenetre vonatkozik, nem írja felül az SMS Gateway beállítások oldalon megadott alapértelmezett URL-t. |
reference | String | nem | Általunk választott tetszőleges üzenetazonosító. Callback hívásnál visszakapjuk, ezzel tudjuk beazonosítani kiküldött üzenetünket. |
method | String | nem | A Gateway-hívás célja. Esetünkben elhagyható, ugyanis alapértelmezetten 'sms', ez hívja meg az SMS-küldés metódust. |
format | String | nem | A válasz formátuma: text, json vagy xml (Opcionális, ha nem adjuk meg akkor az SMS Gateway beállítások oldalon megadott alapértelmezett formátumban kapjuk vissza az adatokat). |
Példa:
https://seeme.hu/gateway?key=c2415537c8fca33feab37f0017faddf1fe5a&message=Ez%20az%20%C3%BCzenetem&number=36201234567&callback=4,6,7
A fenti példában az "Ez az üzenetem" szövegű SMS-t küldjük ki a 36201234567 telefonszámra.
Kapott válasz
A kapott válasz az alábbi paramétereket tartalmazza:
Paraméter | Típus | Érték |
---|---|---|
result | String | Sikeres küldésnél 'OK', hiba esetén 'ERR' |
price | Float | Prefix alapján kalkulált ár. Vigyázat! A tényleges ár eltérhet ettől számhordozott telefonszám esetén. A végleges valós árat csak a callback-ben kapjuk vissza. |
code | Int | Sikeres küldésnél 0, hiba esetén a hiba kódja. |
message | String | A sikeres átvétel vagy a hiba leírása szöveges formában. |
charset | String | A kiküldött üzenet karakterkódolása. Lehet: GSM-7 ill. UTF-8. |
split | Int | Összefűzött SMS esetén a szövegrészletek darabszáma. |
length | Int | Kiküldött üzenet hossza (karakter) |
Példa válasz text formátumban:
result=OK&price=14&code=0&message=Your+message+has+been+successfully+received+by+the+Gateway.&charset=GSM-7&split=1&length=5
Példa válasz JSON formátumban:
{"result":"OK","price":14,"code":0,"message":"Your message has been successfully received by the Gateway.","charset":"GSM-7","split":1,"length":5}
Példa válasz XML formátumban:
<?xml version="1.0" encoding="utf-8"?>
<response>
<result>OK</result>
<price>14</price>
<code>0</code>
<message>Your message has been successfully received by the Gateway.</message>
<charset>GSM-7</charset>
<split>1</split>
<length>5</length>
</response>
Hiba esetén visszakapott hibakódok listája
(Amennyiben a SeeMe Gateway üzleti előnyeiről és a szolgáltatásról általánosságban szeretnél információt kapni, akkor arról a SeeMe Gateway Áttekintő oldalon olvashatsz bővebben. Ha a technikai dokumentációk és az integráláshoz szükséges infomációk érdekelnek, akkor a SeeMe SMS Gateway leírás nyújt Számodra bővebb tájékoztatást.)