Помощен център Ограничения на скоростта

Ограничения на скоростта

За да осигури висока производителност и надеждност за всички потребители, SMSBAT прилага ограничаване на скоростта към API заявките. Ограниченията на скоростта определят максималния брой извиквания на API, които можете да направите в рамките на даден период от време.

Лимити по подразбиране

Освен ако не е посочено друго в договора ви, ограниченията на скоростта по подразбиране се прилагат за всички крайни точки на API (SMSBAT API, Cascade API и ChatHub API).

API КатегорияЛимит по подразбиранеГраница на спукване
Крайни точки за съобщения (/bat/messagelist)100 заявки / секунда150 заявки / секунда
Крайни точки на данни (Състояние, Баланс, Информация)50 заявки / секунда75 заявки / секунда

[!ЗАБЕЛЕЖКА] За изходящи съобщения (напр. POST /bat/messagelist), една HTTP заявка може да съдържа до 5000 съобщения в масива messages. Ограничението на скоростта важи за броя HTTP заявки, а не за броя на изпратените съобщения.

Обработка на ограничения на скоростта

Ако превишите разрешената скорост, API ще отговори с HTTP 429 Too Many Requests код на състоянието.

Пример за отговор

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

Най-добри практики

За да избегнете ограничение на скоростта, разгледайте следните най-добри практики:

  1. Групирайте вашите съобщения: Вместо да изпращате 1000 отделни HTTP заявки за 1000 SMS съобщения, изпратете една заявка, съдържаща масив от 1000 обекта.
  2. Прилагане на експоненциално забавяне: Ако получите код за състояние 429, изчакайте за кратък период (напр. 1 секунда) и опитайте отново. Ако отново се провали, удвоете времето за изчакване (2s, 4s, 8s и т.н.).
  3. Ускорете вашите заявки: Ако изпълнявате автоматизиран скрипт, който задейства хиляди API повиквания, въведете малко забавяне (напр. sleep(10) милисекунди) между заявките.

Искане на увеличение на лимита

Ако вашият случай на използване изисква по-висока пропускателна способност от лимитите по подразбиране, можете да поискате увеличение.

  1. Свържете се с вашия специален мениджър на акаунти или изпратете имейл help@smsbat.com.
  2. Предоставете вашия ID на акаунта и очакваната производителност (напр. 500 заявки в секунда).
  3. Опишете накратко вашия случай на употреба.

Нашият технически екип ще прегледа вашата заявка и съответно ще коригира лимитите ви.