Límites de solicitudes

Para mantener la plataforma rápida y confiable para todos, la API REST de SIP Caller limita la cantidad de solicitudes que puede realizar cada API Key.

Límites

Cada API Key puede realizar hasta 20 solicitudes por segundo, en promedio.

El límite se aplica a cada API Key por separado. Todas las solicitudes cuentan para el límite, incluidas las que fallan.

Solicitar un límite mayor

Si tu integración necesita un límite mayor, contáctanos y explica tu caso de uso: qué hace tu integración, cuántas solicitudes envía y cómo se distribuyen en el tiempo. Lo revisaremos y te ayudaremos a encontrar la mejor solución, que puede incluir aumentar el límite de tu cuenta.

Superar el límite

Cuando se supera el límite, la API devuelve un error 429 Too Many Requests, con un encabezado Retry-After que indica la cantidad de segundos que se debe esperar antes de enviar más solicitudes:

HTTP/1.1 429 Too Many Requests
Retry-After: 5

{
  "type": "https://tools.ietf.org/html/rfc6585#section-4",
  "title": "One or more errors occurred.",
  "status": 429,
  "detail": "Too many requests. Retry after 5 seconds.",
  "instance": "/v1/accounts/ACCOUNT_ID/campaigns",
  "traceId": "0HN6QKQ1B2F3G:00000004"
}

Buenas prácticas

• Respeta el encabezado Retry-After. Cuando recibas un error 429, espera al menos la cantidad de segundos indicada antes de reintentar.
• Usa los endpoints masivos. La mayoría de las operaciones aceptan muchos registros en una sola solicitud. Por ejemplo, agrega cientos de números a una campaña en una sola solicitud de Agregar números, en lugar de una solicitud por número, o sube un archivo CSV.
• Usa webhooks en lugar de consultas periódicas. En lugar de buscar cambios cada pocos segundos, suscríbete a los webhooks para recibir una notificación cuando las campañas cambien de estado o las llamadas finalicen.
• Usa páginas más grandes. Al leer listas largas, solicita páginas de unos pocos cientos de registros en lugar de páginas pequeñas. Consulta Paginación.
• Distribuye los procesos por lotes. Si un proceso envía muchas solicitudes, agrega una breve pausa entre ellas, en lugar de enviarlas todas a la vez.