Activăm organizația
Administratorul creează contul clientului, configurează tariful per SMS, creditul inițial și limita de trimitere.
Fluxul complet, pas cu pas
Primești cheia API
Cheia începe cu sms_live_, este afișată o singură dată și trebuie păstrată într-un mediu securizat.
Trimiți cererea
Aplicația trimite numărul în format internațional E.164 și conținutul mesajului către endpointul API.
Mesajul intră în coadă
Creditul este rezervat, iar trimiterea este procesată în fundal fără să blocheze cererea aplicației.
Comanda este executată
Workerul SMS24 transmite în siguranță numărul și textul către infrastructura de livrare configurată.
Urmărești rezultatul
Statusul devine sent sau failed. La eșec definitiv, creditul este restituit automat.
Exemplu de integrare
POST https://api.sms24.ro/api/v1/messages
X-API-Key: sms_live_••••••••
Content-Type: application/json
{
"to": "+40722123456",
"text": "Codul tau este 482913"
}
X-API-Key: sms_live_••••••••
Content-Type: application/json
{
"to": "+40722123456",
"text": "Codul tau este 482913"
}
Limitarea trimiterilor
Fiecare client are propria limită. Configurația implicită este un SMS la cinci secunde, dar administratorul poate modifica atât numărul mesajelor, cât și intervalul. Dacă limita este depășită, API-ul răspunde cu statusul 429 și indică timpul de așteptare.
Important: limita este aplicată organizației, nu doar unei chei, astfel încât nu poate fi ocolită prin generarea mai multor chei API.
Credit și erori
Costul configurat pentru client este rezervat când mesajul intră în coadă. Erorile temporare sunt reîncercate automat. Dacă toate încercările eșuează, mesajul este marcat ca eșuat și suma este returnată în sold.