Limites de débit RTC
Le RTC API limite le nombre de requêtes qu’il accepte dans un intervalle de temps donné. Ces limites protègent les salles de chaque client contre un seul client incontrôlable ; elles ne constituent pas un compteur de facturation.
Quelles sont les limitations ?
Section intitulée « Quelles sont les limitations ? »| Limite | Chiffres | Objectif |
|---|---|---|
| Par adresse IP | Chaque requête provenant d’une même adresse, que l’utilisateur soit connecté ou non | Protection contre les abus ; la couche la plus basse |
| Par API clé | Les requêtes effectuées avec une seule APIclé de projet | Cela évite qu’une intégration ou une clé divulguée ne bloque les autres |
| Par organisation | Requêtes de toutes les clés et sessions de console d’une organisation RTC | Répartition équitable entre les clients |
Une requête doit respecter toutes les limites qui lui sont applicables. Les limites par clé et par organisation dépendent de votre forfait, et CHAMPREP vous pouvez les ajuster pour une organisation. Consultez les en-têtes ci-dessous plutôt que de coder en dur des valeurs numériques.
Certaines opérations ont leurs propres limites, plus restrictives, qui donnent lieu à un code de réponse spécifique, par exemple les rediffusions de webhooks (REPLAY_QUOTA) et les messages de l’application au sein de la salle (MESSAGE_RATE_LIMITED).
En-têtes
Section intitulée « En-têtes »Les réponses authentifiées indiquent la limite la plus restrictive qui s’applique :
| En-tête | Signification |
|---|---|
X-RateLimit-Limit | Requêtes autorisées dans la fenêtre actuelle |
X-RateLimit-Remaining | Demandes restantes dans la fenêtre actuelle |
X-RateLimit-Reset | Nombre de secondes avant la réinitialisation de la fenêtre |
Une requête dépassant une limite renvoie une réponse 429 avec le code
RATE_LIMITED et un Retry-After en-tête, en secondes.
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-0f4b9b1d7c21Les chiffres ci-dessus sont donnés à titre indicatif.
Respectez correctement les délais d’attente
Section intitulée « Respectez correctement les délais d’attente »- Sur
429, attendez au moinsRetry-Aftersecondes avant la requête suivante, puis reprenez progressivement. Ne réessayez pas dans une boucle serrée. - Répartissez les tâches périodiques (interrogation, réconciliation) dans le temps, et privilégiez webhooks au polling.
- Utilisez une API clé par intégration : sa propre limite permet alors de contenir une tâche hors de contrôle, et vous pouvez révoquer une clé sans affecter les autres.
- Générez les identifiants des participants au moment où un utilisateur rejoint effectivement le projet, et non à l’avance. En cas de volumes élevés d’adhésions, générer des jetons d’adhésion hors ligne à l’aide d’une clé de signature du projet.
- Utilisez
?limitet?cursorpour parcourir les listes plutôt que de répéter des demandes de liste complètes.