Sari la conținut

Limite de rate

Pentru a asigura performanță și fiabilitate ridicate pentru toți utilizatorii, SMSBAT aplică limitarea ratei solicitărilor API. Limitele ratei specifică numărul maxim de apeluri API pe care le puteți efectua într-un anumit interval de timp.

Limite implicite

Cu excepția cazului în care se specifică altfel în contract, limitele prestabilite ale ratei sunt aplicate tuturor punctelor finale API (API-ul SMSBAT, API-ul Cascade și API-ul ChatHub).

Categoria API Limită implicită Limită de explozie
Punctele finale de mesagerie (/bat/messagelist) 100 de cereri / secundă 150 cereri/secundă
Punctele finale de date (Stare, Sold, Informații) 50 cereri/secundă 75 cereri / secundă

[!NOTĂ] Pentru mesajele de ieșire (de exemplu, POST /bat/messagelist), o solicitare HTTP poate conține până la 5.000 de mesaje în matricea messages. Limita de rată se aplică numărului de solicitări HTTP, nu numărului de mesaje trimise.

Gestionarea limitelor ratei

Dacă depășiți limita de rată permisă, API-ul va răspunde cu un cod de stare HTTP „429 Too Many Requests”.

Exemplu de răspuns

{
  "error": "Too Many Requests",
  "message": "Rate limit exceeded. Please wait before sending more requests.",
  "status": 429
}

Cele mai bune practici

Pentru a evita limitarea ratei, luați în considerare următoarele bune practici:

  1. Agrupați-vă mesajele: în loc să trimiteți 1.000 de solicitări HTTP separate pentru 1.000 de mesaje SMS, trimiteți o singură solicitare care conține o matrice de 1.000 de obiecte.
  2. Implementați retragerea exponențială: dacă primiți un cod de stare „429”, așteptați o perioadă scurtă (de exemplu, 1 secundă) și încercați din nou. Dacă eșuează din nou, dublați timpul de așteptare (2s, 4s, 8s etc.).
  3. Patează-ți solicitările: dacă rulezi un script automat care declanșează mii de apeluri API, introduceți o mică întârziere (de exemplu, „sleep(10)” milisecunde) între solicitări.

Solicitarea unei creșteri a limitei

Dacă cazul dvs. de utilizare necesită un debit mai mare decât limitele implicite, puteți solicita o creștere.

  1. Contactați managerul de cont dedicat sau e-mail [email protected].
  2. Furnizați ID-ul contului și debitul așteptat (de exemplu, 500 de solicitări pe secundă).
  3. Descrieți pe scurt cazul dvs. de utilizare.

Echipa noastră tehnică vă va examina solicitarea și vă va ajusta limitele în consecință.