Ir al contenido
Documentation

Límites de tasa de RTC

El RTC API limita el número de solicitudes que acepta en un intervalo de tiempo. Estos límites protegen las salas de cada cliente frente a un único cliente descontrolado; no constituyen un medidor de facturación.

LímiteRecuentosObjetivo
Por dirección IPCada solicitud procedente de una misma dirección, esté o no conectadaProtección contra el uso indebido; la capa más baja
Por API claveSolicitudes realizadas con una APIclave de proyectoEvite que una integración o una clave filtrada sature a las demás
Por organizaciónSolicitudes de todas las claves y sesiones de consola de una organización RTCDistribución equitativa entre los clientes

Una solicitud debe cumplir todos los límites que le sean aplicables. Los límites por clave y por organización dependen de su plan, y CHAMPREP puede ajustarlos para una organización. Consulte los encabezados que figuran a continuación en lugar de codificar los números de forma fija.

Algunas operaciones tienen sus propios límites, más restrictivos, que se indican con un código específico; por ejemplo, las repeticiones de webhooks (REPLAY_QUOTA) y mensajes de la aplicación dentro de la sala (MESSAGE_RATE_LIMITED).

Las respuestas autenticadas incluyen el estado del límite más estricto que se aplica:

EncabezadoSignificado
X-RateLimit-LimitSolicitudes permitidas en la ventana actual
X-RateLimit-RemainingSolicitudes pendientes en la ventana actual
X-RateLimit-ResetSegundos hasta que se reinicie la ventana

Una solicitud que supere el límite responde 429 con el código RATE_LIMITED y un Retry-After encabezado, en segundos.

HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 600
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12
X-Error-Code: RATE_LIMITED
X-Request-Id: 6f1c2b8e-1d2a-4c55-9a8e-0f4b9b1d7c21

Las cifras anteriores son meramente ilustrativas.

  • En 429, espere al menos Retry-After segundos antes de la siguiente solicitud y, a continuación, reanude la actividad de forma gradual. No vuelva a intentarlo en un bucle cerrado.
  • Distribuya las tareas periódicas (sondeos, reconciliación) a lo largo del tiempo y dé preferencia a webhooks en lugar de realizar sondeos.
  • Utilice una APIclave por integración: su propio límite contiene entonces un trabajo fuera de control, y puede revocar una clave sin que ello afecte a las demás.
  • Genere las credenciales de los participantes cuando un usuario se incorpore realmente, no por adelantado. En caso de elevados volúmenes de incorporaciones, generar tokens de incorporación sin conexión con una clave de firma del proyecto.
  • Utilice ?limit y ?cursor para desplazarse por las listas en lugar de repetir solicitudes de listas completas.