SMS Gateway returneaza dupa fiecare apelare un raspuns in fisierul care a fost apelat sub forma de continut in format JSON. Raspunsurile transmise de SMS Gateway pot fi salvate si interpretate daca este cazul de aplicatia dvs., prin citirea continutului din fisier imediat dupa apelare. Astfel raspunsul returnat de SMS Gateway are o forma standard pentru a putea fi interpretata daca este cazul.
Formatul raspunsului JSON este urmatorul pentru toate raspunsurile returnate de SMS Gateway JSON:
"response_type":"ERROR",
"response_id":"1",
"response_message":"Insufficient arguments for SMS Gateway!"
}
Parametrii returnati in format JSON au urmatoarele semnificatii:
response_type - raspunsurile returnate de SMS Gateway se impart in doua mari categorii: MESSAGE - care are rol de confirmare a operatiunii care a avut loc si returnarea de variabile utile urmaririi operatiunii si ERROR - care are rol de raportare anuntare si raportare a unei erori care a fost intampinata in procesarea cererii. Categoria raspuns returnata este case sensitive.
response_id - reprezinta o valoare numerica ce corespunde fiecarui mesaj de raspuns aferent response_type MESSAGE sau ERROR, returnat de SMS Gateway. Astfel pentru situatia in care response_type are valoarea MESSAGE, response_id va avea o valoare numerica ce incepe de la 1 la n, iar pentru situatia in care response_type are valoarea ERROR response_id va avea o valoare numerica ce incepe de la 1 la n.
response_message - este un sir de caractere text ce descrie eroarea ce a fost intampinata pentru a fi mai usor de recunoscut in faza de dezvoltare si a nu fi nevoie sa se consulte documentatia cu lista de erori si mesaje posibile pentru a se face corelatii manuale.
In situatia in care valoarea response_type are valoarea MESSAGE, in raspunsul JSON se vor mai adauga urmatorii parametrii, in functie de endpoint-ul apelat:
Parametrii aditionali returnati pentru endpoint-ul sms/gateway/communicate/json.php
message_id - ID-ul unic al SMS-ului din platforma SMSLink, reprezentat de o valoare numerica de ordinul sutelor de milioane
receiver - destinatarul SMS-ului
sender - expeditorul SMS-ului
Parametrii aditionali returnati pentru endpoint-ul sms/gateway/communicate/json.php?mode=Credit
credit - numarul de SMS-uri disponibile in contul de utilizator
timestamp - date / ora procesarii request-ului, in format UNIX timestamp
Inregistrati-va si testati gratuit toate serviciile SMSLink