API

Zona Programatori

API-ul Robo SMS vă permite să vă conectați software-ul intern sau CRM-ul la gateway-ul nostru de SMS, trimițând mesaje SMS la fel cum ați face pe platforma noastră, dar la doar un clic de buton în propriul 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 va fi dedus pentru 480 de caractere. Creditele vor fi deduse numai pentru numerele de telefon introduse 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"
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"
opțional

Răspuns

Răspuns primit după cerere

Exemplu de răspuns la succes:
{
    "success": True,
}
 Totul funtioneaza corespunzator.
Exemplu de eroare la răspuns:

This field may not be blank.
Această eroare este primită când lipsesc câmpurile "catre" și / sau "conținut". 

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 recepționată atunci când numărul de contacte de la "catre" este mai mare decât numărul de 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 este recepționată atunci când numărul sms calculat este mai mare decât sms-urile rămase care ar putea fi trimise de pe dispozitivele dvs. 1 SMS reprezintă 480 de caractere sau nu există niciun dispozitiv care să poată fi utilizat.