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.
Qué está limitado
Sección titulada «Qué está limitado»| Límite | Recuentos | Objetivo |
|---|---|---|
| Por dirección IP | Cada solicitud procedente de una misma dirección, esté o no conectada | Protección contra el uso indebido; la capa más baja |
| Por API clave | Solicitudes realizadas con una APIclave de proyecto | Evite que una integración o una clave filtrada sature a las demás |
| Por organización | Solicitudes de todas las claves y sesiones de consola de una organización RTC | Distribució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).
Encabezados
Sección titulada «Encabezados»Las respuestas autenticadas incluyen el estado del límite más estricto que se aplica:
| Encabezado | Significado |
|---|---|
X-RateLimit-Limit | Solicitudes permitidas en la ventana actual |
X-RateLimit-Remaining | Solicitudes pendientes en la ventana actual |
X-RateLimit-Reset | Segundos 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 RequestsRetry-After: 12X-RateLimit-Limit: 600X-RateLimit-Remaining: 0X-RateLimit-Reset: 12X-Error-Code: RATE_LIMITEDX-Request-Id: 6f1c2b8e-1d2a-4c55-9a8e-0f4b9b1d7c21Las cifras anteriores son meramente ilustrativas.
Aplique el retroceso de forma correcta
Sección titulada «Aplique el retroceso de forma correcta»- En
429, espere al menosRetry-Aftersegundos 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
?limity?cursorpara desplazarse por las listas en lugar de repetir solicitudes de listas completas.