Zum Inhalt springen
Documentation

RTC-Ratenbegrenzungen

Das RTC API begrenzt die Anzahl der Anfragen, die es innerhalb eines Zeitfensters akzeptiert. Diese Begrenzungen schützen die Räume jedes Kunden vor einem einzelnen außer Kontrolle geratenen Client; sie dienen nicht als Abrechnungszähler.

LimitZählungenZweck
Pro IP-AdresseJede Anfrage von einer Adresse, unabhängig davon, ob der Nutzer angemeldet ist oder nichtSchutz vor Missbrauch; die unterste Ebene
Pro API SchlüsselAnfragen, die mit einem ProjektschlüsselAPI gestellt werdenSo wird verhindert, dass eine einzelne Integration oder ein offengelegter Schlüssel die anderen ausbremst
Pro OrganisationAnfragen aller Schlüssel und Konsolensitzungen einer RTC-OrganisationGerechte Verteilung auf alle Kunden

Eine Anfrage muss alle für sie geltenden Limits einhalten. Die Limits pro Schlüssel und pro Organisation hängen von Ihrem Tarif ab und CHAMPREP können für eine Organisation angepasst werden. Lesen Sie die folgenden Kopfzeilen, anstatt Zahlen fest zu programmieren.

Einige Vorgänge unterliegen eigenen, enger gefassten Beschränkungen, die mit einem bestimmten Code beantwortet werden, beispielsweise Webhook-Wiederholungen (REPLAY_QUOTA) sowie App-Nachrichten innerhalb des Raums (MESSAGE_RATE_LIMITED).

Authentifizierte Antworten enthalten den Status der strengsten geltenden Beschränkung:

HeaderBedeutung
X-RateLimit-LimitIm aktuellen Fenster zulässige Anfragen
X-RateLimit-RemainingIm aktuellen Fenster verbleibende Anfragen
X-RateLimit-ResetSekunden bis zum Zurücksetzen des Zeitfensters

Eine Anfrage, die ein Limit überschreitet, führt zu folgender Antwort: 429 mit dem Code RATE_LIMITED und ein Retry-After Header, in Sekunden.

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

Die oben genannten Zahlen dienen lediglich der Veranschaulichung.

  • Auf 429, warten Sie mindestens Retry-After Sekunden vor der nächsten Anfrage abwarten und dann schrittweise fortfahren. Versuchen Sie es nicht in einer engen Schleife erneut.
  • Verteilen Sie periodische Aufgaben (Abfragen, Abgleich) über einen längeren Zeitraum und bevorzugen Sie Webhooks anstelle von Polling.
  • Verwenden Sie einen APISchlüssel pro Integration: Dessen eigenes Limit begrenzt dann einen außer Kontrolle geratenen Job, und Sie können einen Schlüssel widerrufen, ohne die anderen zu beeinträchtigen.
  • Erstellen Sie Teilnehmer-Zugangsdaten erst dann, wenn ein Nutzer tatsächlich beitritt, nicht im Voraus. Bei hohem Beitrittsaufkommen, Beitrittstoken offline generieren mit einem Projekt- Signaturschlüssel.
  • Verwenden Sie ?limit und ?cursor um durch Listen zu blättern, anstatt vollständige Listenabfragen zu wiederholen.