Integrare API SMS

Zona Programatori

API-ul Robo SMS îți permite să conectezi software-ul intern sau CRM-ul la gateway-ul nostru SMS, trimițând mesaje SMS exact ca pe platforma noastră, dar cu un singur clic în propriul tău sistem.

Call to action image

Introducere

Interfața noastră API este utilizată pentru a integra capabilitățile serviciului de distribuție ROBO-SMS cu proiectele personale ale clientului.
API este conceput pentru dezvoltatori și este însoțit de o documentație detaliată.

Autorizare

Token de autentificare personală

Acest token va fi folosit pentru a vă autentifica pentru fiecare solicitare api pe care o veți face. Pentru a vă autentifica, este obligatoriu să utilizați tokenul în fiecare antet de solicitare ca în exemplu:

{
    Authorization: Basic ExampleTokenx0x0x0x0x0x0x0x0x0x0,
}

Trimite mesaj

Pentru a trimite un mesaj, trebuie să faceți o solicitare POST la acest api url: robo-sms.com/api/sms/ cu aplicație de tip content / json.

Exemplu:
POST https://robo-sms.com/api/sms/
Content-Type: application/json
Authorization: Basic ExampleTokenx0x0x0x0x0x0x0x0x0x0

{
    "content": "Message content",
    "to": "+40740123XXX",
    "country_code": "RO",
    "device_id": "optional device id"
}

Descrierea parametrilor

"content"
String, obligatoriu
Reprezintă conținutul mesajului SMS. 1 credit acoperă 480 caractere; caracterele din afara alfabetului GSM-7 (diacritice, emoji etc.) se numără câte 2. Creditele se scad doar pentru numerele de telefon formatate corect.

"to"
String, obligatoriu
Reprezintă numărul de telefon al destinatarului.
Numărul trebuie să fie în format internațional E.164 (Ex: +4070123456)

"country_code"
String, opțional
Reprezentați prefixul numărului de telefon. Numerele de telefon vor fi formate corespunzător. De exemplu: 'to': '0723555666', 'country_code': 'RO' va rezulta '+40723555666', altfel prefixul numerelor de telefon va fi obligatoriu.

"device_id"
String, opțional

Răspuns

Răspuns primit după cerere

Exemplu de răspuns la succes:
{
    "success": True,
}
 Totul funcționează conform așteptărilor.
Exemplu de eroare la răspuns:

This field may not be blank.
Această eroare este primită când câmpurile „to” și/sau „content” lipsesc. 

No data was provided.
Această eroare este primită când json body este gol. 

Incorrect format.
Această eroare este recepționată atunci când datele furnizate nu au tipul de conținut corect. 

Incorrect or unknown token.
Această eroare este înregistrată la postarea cu un token incorect. 

You do not have enough credits.
Această eroare este primită atunci când nu aveți suficiente credite. 


Invalid phone number.
Această eroare este primită dacă numărul de telefon furnizat nu este valabil, respectiv numărul de telefon nu are prefix și/sau nu este furnizat codul țării sau numărul nu este valabil pentru codul țării specificat. 

Your devices can not send the number of sms calculated from your   contacts number and message length.
Această eroare apare atunci când mesajul ar consuma mai multe credite decât are utilizatorul, sau când nu este disponibil niciun dispozitiv. 1 credit acoperă 480 caractere de text GSM-7; caracterele din afara alfabetului GSM-7 (diacritice, emoji etc.) se numără câte 2.