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.
Was ist begrenzt?
Abschnitt betitelt „Was ist begrenzt?“| Limit | Zählungen | Zweck |
|---|---|---|
| Pro IP-Adresse | Jede Anfrage von einer Adresse, unabhängig davon, ob der Nutzer angemeldet ist oder nicht | Schutz vor Missbrauch; die unterste Ebene |
| Pro API Schlüssel | Anfragen, die mit einem ProjektschlüsselAPI gestellt werden | So wird verhindert, dass eine einzelne Integration oder ein offengelegter Schlüssel die anderen ausbremst |
| Pro Organisation | Anfragen aller Schlüssel und Konsolensitzungen einer RTC-Organisation | Gerechte 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:
| Header | Bedeutung |
|---|---|
X-RateLimit-Limit | Im aktuellen Fenster zulässige Anfragen |
X-RateLimit-Remaining | Im aktuellen Fenster verbleibende Anfragen |
X-RateLimit-Reset | Sekunden 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 RequestsRetry-After: 12X-RateLimit-Limit: 600X-RateLimit-Remaining: 0X-RateLimit-Reset: 12X-Error-Code: RATE_LIMITEDX-Request-Id: 6f1c2b8e-1d2a-4c55-9a8e-0f4b9b1d7c21Die oben genannten Zahlen dienen lediglich der Veranschaulichung.
Wenden Sie die Backoff-Regel korrekt an
Abschnitt betitelt „Wenden Sie die Backoff-Regel korrekt an“- Auf
429, warten Sie mindestensRetry-AfterSekunden 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
?limitund?cursorum durch Listen zu blättern, anstatt vollständige Listenabfragen zu wiederholen.