Aller au contenu
Documentation

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.

LimiteChiffresObjectif
Par adresse IPChaque requête provenant d’une même adresse, que l’utilisateur soit connecté ou nonProtection contre les abus ; la couche la plus basse
Par API cléLes requêtes effectuées avec une seule APIclé de projetCela évite qu’une intégration ou une clé divulguée ne bloque les autres
Par organisationRequêtes de toutes les clés et sessions de console d’une organisation RTCRé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).

Les réponses authentifiées indiquent la limite la plus restrictive qui s’applique :

En-têteSignification
X-RateLimit-LimitRequêtes autorisées dans la fenêtre actuelle
X-RateLimit-RemainingDemandes restantes dans la fenêtre actuelle
X-RateLimit-ResetNombre 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 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

Les chiffres ci-dessus sont donnés à titre indicatif.

  • Sur 429, attendez au moins Retry-After secondes 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 ?limit et ?cursor pour parcourir les listes plutôt que de répéter des demandes de liste complètes.