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 API4 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 -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ă.