Parametrii Gateway-ului de SMS
Aici găseşti parametrii pe care le poţi folosi în SeeMe SMS Gateway.
Parametru | Tip | Obligatoriu | Valoare |
---|---|---|---|
key | String | DA | Cheia API pentru autentificare SeeMe SMS Gateway. Dacă nu ai încă, aici poţi crea una: Setările SMS Gateway |
message | String | DA | Mesajul de trimis în codificare UTF-8! |
number | Int | DA | Numărul destinatarului în format internaţional |
sender | String | nu | Identificatorul expeditorului |
callback | String | nu | Acele coduri de stare separate cu virgulă despre care vrem să primim notificare în format de apel callback |
reference | String | nu | Un identificator de mesaj opţional. Cu acesta putem identifica mesajul trimis la apelul callback. |
method | String | nu | Motivul din care am apelat gateway-ul. Este opţional deoarece dacă nu este specificat, va primi valoarea 'sms' - acesta va apela metoda de trimitere SMS. |
format | String | nu | Formatul răspunsului: text, json sau xml. (Este opţional, dacă nu este dat atunci vom primi datele în formatul default setat pe pagina Setările SMS Gateway |
Exemplu:
https://seeme.ro/gateway?key=c2415537c8fca33feab37f0017faddf1fe5a&message=Acesta%20este%20mesajul%20meu&number=40744123456&callback=4,6,7
În acest exemplu trimitem mesajul "Acesta este mesajul meu" pe numărul 40744123456.
Răspunsul primit
Răspunsul primit conţine următorii parametrii:
Parametru | Tip | Valoare |
---|---|---|
result | String | Trimitere de succes: 'OK', în caz de eroare: 'ERR' |
price | Float | Preţul calculat pe baza prefixului. Atenţie! Preţul efectiv poate să difere dacă numărul este portat. Preţul final îl primim în callback. |
code | Int | Trimitere de succes: 0, în caz de eroare: codul erorii. |
message | String | Descrierea preluării de succes sau a erorii. |
charset | String | Codificarea caracterelor în mesajului trimis. Poate fi GSM-7 sau UTF-8. |
split | Int | Dacă mesajul constă din mai multe SMS-uri, numărul acestora |
length | Int | Lungimea mesajului trimis (câte caractere) |
Răspuns de exemplu în format text:
result=OK&price=14&code=0&message=Your+message+has+been+successfully+received+by+the+Gateway.&charset=GSM-7&split=1&length=5
Răspuns în format JSON:
{"result":"OK","price":14,"code":0,"message":"Your message has been successfully received by the Gateway.","charset":"GSM-7","split":1,"length":5}
Răspuns în format XML:
<?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>
Lista codurilor de stare în caz de eroare
(Dacă vrei să afli informaţii generale despre beneficiile şi serviciile SeeMe Gateway atunci vizitează pagina SeeMe SMS Gateway. Dacă te interesează documentaţiile şi informaţiile legate de implementare, atunci vezi pagina Descrierea de SeeMe SMS Gateway.)