Saltar a contenido

Límites de tarifas

Para garantizar un alto rendimiento y confiabilidad para todos los usuarios, SMSBAT aplica limitación de velocidad a las solicitudes de API. Los límites de velocidad especifican la cantidad máxima de llamadas API que puede realizar dentro de un período de tiempo determinado.

Límites predeterminados

A menos que se especifique lo contrario en su contrato, los límites de tasa predeterminados se aplican en todos los puntos finales de API (API SMSBAT, API Cascade y API ChatHub).

Categoría API Límite predeterminado Límite de ráfaga
Puntos finales de mensajería (/bat/messagelist) 100 solicitudes/segundo 150 solicitudes/segundo
Puntos finales de datos (estado, saldo, información) 50 solicitudes/segundo 75 solicitudes/segundo

[!NOTA] Para mensajes salientes (por ejemplo, POST /bat/messagelist), una solicitud HTTP puede contener hasta 5000 mensajes en la matriz messages. El límite de velocidad se aplica a la cantidad de solicitudes HTTP, no a la cantidad de mensajes enviados.

Límites de tasa de manejo

Si excede el límite de velocidad permitido, la API responderá con un código de estado HTTP "429 Demasiadas solicitudes".

Ejemplo de respuesta

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

Mejores prácticas

Para evitar tener una tasa limitada, considere las siguientes mejores prácticas:

  1. Agrupe sus mensajes: en lugar de enviar 1000 solicitudes HTTP separadas para 1000 mensajes SMS, envíe una sola solicitud que contenga una matriz de 1000 objetos.
  2. Implementar retroceso exponencial: si recibe un código de estado "429", espere un breve período (por ejemplo, 1 segundo) y vuelva a intentarlo. Si vuelve a fallar, duplica el tiempo de espera (2s, 4s, 8s, etc.).
  3. Acelere sus solicitudes: si está ejecutando un script automatizado que activa miles de llamadas API, introduzca un pequeño retraso (por ejemplo, sleep(10) milisegundos) entre solicitudes.

Solicitar un aumento de límite

Si su caso de uso requiere un rendimiento mayor que los límites predeterminados, puede solicitar un aumento.

  1. Comuníquese con su administrador de cuentas exclusivo o envíe un correo electrónico a [email protected].
  2. Proporcione su ID de cuenta y el rendimiento esperado (por ejemplo, 500 solicitudes por segundo).
  3. Describe brevemente tu caso de uso.

Nuestro equipo técnico revisará su solicitud y ajustará sus límites en consecuencia.