Documentatie de integrare

Urmatoarea sectiune descrie modul in care poti trimite SMS, primi SMS, obtine raportul de livrare si verifica creditul contului. Daca ai nevoie de asistenta tehnica contacteaza-ne.

Trimitere SMS

Pentru a te conecta la API, poti face o cerere HTTP GET catre urmatoarea adresa:
http://www.whosms.ro/send.php

user
Numele tau de utilizator la WhoSMS
pass
Parola ta
catre
Destinatarul mesajului in format international excluzand "+" (ex. 40722xxxxxx)
Pentru a trimite catre mai multe numere simultan, trebuie sa separi aceste numere printr-o virgula "," (ex. 40722xxxxxx,40766xxxxxx,40744xxxxxx).
Retine ca poti trimite maxim pana la 300 de destinatari intr-o singura cerere HTTP GET, in functie de lungimea sirului total de caractere. Aceasta lungime nu trebuie sa depaseasca 1024 caractere (limitare HTTP GET)
dela
Expeditorul mesajului (minim 3 caractere, maxim 11). Caractere valide: A-z, 1-9 si fara spatii
mesaj
Continutul mesajului text. Poate avea pana la 612 caractere in lungime. Un singur mesaj are 160 de caractere, iar mesajele duble sunt formate din mesaje simple de 153 caractere (2=306 caractere, 3=459 caractere, 4=612 caractere).
Acest camp trebuie sa fie URL ENCODED (http://php.net/manual/en/function.urlencode.php)
orangesender
[optional] Daca este setat la 1 (&orangesender=1) atunci eticheta expeditorului in reteaua Orange va fi alfanumerica
flash
[optional] Daca este setat la 1 (&flash=1) atunci tipul mesajului va fi flash, va fi afisat doar pe ecranul telefonului fara a se salva in casuta de intrari

Citeste exemple de cod pentru a vedea cum functioneaza.


Primire SMS

Pentru a primi un SMS, trebuie sa setezi un URL unde iti vom trimite prin HTTP GET urmatoarele variabile:

expeditor
Numarul care a trimis mesajul
destinatar
Numarul scurt pe care ai primit mesajul
mesaj
Continutul mesajului primit
data
Data si ora receptionarii mesajului
operator
Operatorul de telefonie mobila din care face parte expeditorul

Citeste exemple de cod pentru a vedea cum functioneaza.


Raport de livrare

Pentru a verifica raportul de livrare a unui mesaj expediat trebuie sa trimiti o cerere HTTP GET cu variabilele din tabelul de mai jos catre:
http://www.whosms.ro/raport.php

id
Un ID unic pentru fiecare mesaj pe care sistemul il genereaza la expediere
numar
Numarul de telefon pentru care vrei sa obtii raportul de livrare

Citeste exemple de cod pentru a vedea cum functioneaza.


Verificare credit

Pentru a verifica creditul trebuie sa trimiti o cerere HTTP GET cu variabilele din tabelul de mai jos catre:
http://www.whosms.ro/balanta.php

user
Numele tau de utilizator la WhoSMS
pass
Parola ta

Citeste exemple de cod pentru a vedea cum functioneaza.