Pentru Dezvoltatori

SMS API Gateway

SMSPro foloseste REST peste JSON ca interfata principala pentru SMS, OTP, evenimente ecommerce, colete si confirmari de comanda. Pentru sisteme legacy exista si adaptoare HTTP GET/form POST si SOAP SendSms, toate trecand prin aceleasi reguli de autentificare, suprimare si credite. Trimiterea bulk accepta JSON sau CSV, iar webhook-urile trimit evenimentele emise de platforma.

Obține Cheia API

4 interfețe API

REST JSON

Interfața recomandată

HTTP GET/POST

Compatibilitate sisteme legacy

SOAP

Operația SendSms

BULK

JSON sau CSV, până la 250

Exemplu real de trimitere

cURL
curl -X POST https://smspro.ro/api/v1/sms/send \
  -H "Authorization: Bearer sk_..." \
  -H "Content-Type: application/json" \
  -d '{"to": "+40712345678", "message": "Comanda 1042 a fost expediata."}'

Caracteristici verificabile

Autentificare API Key

Bearer token sau x-api-key

Listă de IP-uri

Cheia poate restricționa accesul pe IP

Webhooks

Evenimente semnate către endpoint-ul tău

Rate limiting

Limită configurabilă pe cheia API

HTTPS

Endpoint-urile publice sunt servite prin HTTPS

Status Codes

Răspunsuri HTTP explicite pentru succes și erori

API-ul si documentatia au roluri diferite

Aceasta pagina explica pe scurt cand folosesti API-ul. Lista exacta de endpoint-uri, campuri, coduri de raspuns si evenimente webhook este tinuta pe pagina pentru developeri, unde fiecare endpoint este verificat fata de fisierul de ruta care il implementeaza si nu este duplicat aici. Asa evitam ca doua pagini publice sa descrie diferit acelasi contract tehnic.

Cand folosesti API-ul

Foloseste REST JSON pentru integrari noi. Daca un ERP vechi poate face doar GET, form POST sau SOAP, foloseste adaptoarele de compatibilitate; ele traduc cererea in acelasi sender canonic, deci nu creeaza un flux paralel cu reguli diferite. Pentru magazine ecommerce exista si webhook-uri de comenzi cu mapare de campuri.

Autentificare si limite reale

Cheile API sunt trimise de regula ca Bearer token, pot avea lista de IP-uri permise si o limita de cereri pe minut. Nu publicam o limita universala inventata: limita este asociata cheii. Trimiterea in masa accepta cel mult 250 de mesaje intr-un apel; volumele mai mari apartin fluxului de campanie.

Intrebari frecvente

Exista API SOAP?
Da. /api/v1/soap expune operatia SendSms si livreaza WSDL la GET. Este un adaptor de compatibilitate peste acelasi flux de trimitere folosit de REST, nu un motor separat. Pentru integrari noi recomandarea ramane REST JSON.
Unde vad lista completa de endpoint-uri?
Pe pagina /developers. Acolo sunt documentate numai rutele publice care exista in app/api/v1, impreuna cu metoda HTTP, campurile importante si evenimentele webhook pe care codul le emite efectiv.

Începe Integrarea

Generează o cheie API și urmează exemplele din documentația publică.