RTC-Fehler
Jeder RTC-Fehler ist mit einem stabilen, maschinenlesbaren code. Konzentrieren Sie sich auf den Code, niemals auf den Meldungstext: Meldungen können umformuliert werden, Codes werden niemals umbenannt oder für eine andere Bedeutung wiederverwendet.
Zwei Antwortformate
Abschnitt betitelt „Zwei Antwortformate“Standard. Ohne Versionsheader behalten Fehler ihre ursprüngliche Form, sodass bestehende Integrationen davon unberührt bleiben:
{ "error": "Your plan allows 2 webhook endpoints", "code": "WEBHOOK_ENDPOINT_LIMIT" }code ist bei Fehlern vorhanden, die einen bestimmten Code haben. Ältere Fehler enthalten möglicherweise nur ; error; der X-Error-Code Der Header nennt immer den Code.
Strukturierter Envelope. Senden RTC-Version: 2026-11-01 mit einer Anfrage zum Empfang des strukturierten Umschlags:
curl https://api.rtc.champrep.com/v1/webhooks/endpoints \ --header "Authorization: Bearer $RTC_API_KEY" \ --header "RTC-Version: 2026-11-01" \ --header "Content-Type: application/json" \ --data '{ "url": "https://hooks.example.com/rtc" }'{ "error": { "code": "WEBHOOK_ENDPOINT_LIMIT", "message": "Your plan allows 2 webhook endpoints", "details": { "limit": 2, "used": 2 }, "requestId": "6f1c2b8e-1d2a-4c55-9a8e-0f4b9b1d7c21", "retryable": false, "docUrl": "https://docs.champrep.com/services/rtc/errors/#webhook-endpoint-limit" }}| Feld | Bedeutung |
|---|---|
code | Stabiler Code aus dem Katalog |
message | Für Menschen lesbare Erklärung; bitte nicht analysieren |
details | Optionaler strukturierter Kontext, zum Beispiel limit und usedoder issues (die ungültigen Felder) für INVALID_REQUEST |
requestId | Die ID dieser Anfrage, die ebenfalls als X-Request-Id |
retryable | true kann bei einer späteren Wiederholung derselben Anfrage erfolgreich sein |
docUrl | Link zum Eintrag dieses Codes weiter unten |
Die Antwort gibt die Version wieder, die im RTC-Version Header. Ein Datum vor 2026-11-01 behält die Standardform bei. Siehe Versionierung.
Header in jeder Antwort
Abschnitt betitelt „Header in jeder Antwort“| Header | Wann | Bedeutung |
|---|---|---|
X-Request-Id | Jede Antwort | Eindeutige ID der Anfrage. Geben Sie diese an, wenn Sie sich an den Support wenden. |
X-Error-Code | Jeder Fehler | Der stabile Code, in beiden Antwortformaten |
Retry-After | 429und einige 503 | Sekunden, die vor einem erneuten Versuch abgewartet werden sollen |
X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset | Authentifizierte Antworten | Siehe Ratenbegrenzungen |
Fehlerbehandlung
Abschnitt betitelt „Fehlerbehandlung“retryable: false(4xxaußer429): Korrigieren Sie zunächst die Anfrage, die Anmeldedaten, den Plan oder den Status. Eine unveränderte Wiederholung führt zur gleichen Antwort.retryable: true: Wiederholung mit exponentiellem Backoff und Jitter unter Berücksichtigung vonRetry-After. Wiederholen Sie Schreibvorgänge nur, wenn der Vorgang idempotent ist oder nachdem das Ergebnis abgeglichen wurde.401: Die Anmeldeinformationen fehlen, sind abgelaufen oder wurden widerrufen.403: Die Anmeldedaten sind gültig, es fehlt jedoch ein Geltungsbereich, Projektzugriff oder eine Planberechtigung.404gilt auch für Ressourcen, die einer anderen Person gehören. Überprüfen Sie niemals die Identifikatoren anderer Kunden.
Code-Katalog
Abschnitt betitelt „Code-Katalog“GET /v1/error-codes (keine Authentifizierung) gibt den aktuellen Katalog als
{ "codes": [{ "code", "status", "retryable", "description" }] }. Neue Codes können jederzeit hinzugefügt werden; behandeln Sie einen unbekannten Code wie den generischen Code des entsprechenden HTTP-Status.
Generische Codes (einer pro HTTP-Status, werden verwendet, wenn kein spezifischer Code zutrifft)
Abschnitt betitelt „Generische Codes (einer pro HTTP-Status, werden verwendet, wenn kein spezifischer Code zutrifft)“| Code | HTTP | Wiederholbar | Bedeutung |
|---|---|---|---|
INVALID_REQUEST | 400 | nein | Die Anfrage ist fehlerhaft oder ein Feld ist ungültig (details.issues listet die Felder auf). |
UNAUTHENTICATED | 401 | nein | Fehlende, ungültige oder abgelaufene Anmeldedaten. |
PAYMENT_REQUIRED | 402 | nein | Es ist eine Zahlung fällig, bevor diese Funktion genutzt werden kann. |
FORBIDDEN | 403 | nein | Die Anmeldedaten sind gültig, aber für diese Aktion nicht berechtigt. |
NOT_FOUND | 404 | nein | Die Ressource existiert nicht oder ist für diese Anmeldedaten nicht sichtbar. |
CONFLICT | 409 | nein | Die Anfrage steht im Widerspruch zum aktuellen Status. |
PAYLOAD_TOO_LARGE | 413 | nein | Der Anfragetext ist zu groß. |
UNSUPPORTED_MEDIA_TYPE | 415 | nein | Der Inhaltstyp wird nicht akzeptiert. |
RANGE_NOT_SATISFIABLE | 416 | nein | Der angeforderte Byte-Bereich ist ungültig oder nicht verfügbar. |
UNPROCESSABLE | 422 | nein | Der Inhalt wurde verstanden, kann jedoch nicht verarbeitet werden. |
RATE_LIMITED | 429 | Ja | Zu viele Anfragen; warten Sie, bis Retry-After Sekunden. |
INTERNAL | 500 | Ja | Unerwarteter Serverfehler; versuchen Sie es später erneut. |
SERVICE_UNAVAILABLE | 503 | Ja | Vorübergehend nicht verfügbar; versuchen Sie es mit einer Wartezeit erneut. |
Abonnement und Kontingent
Abschnitt betitelt „Abonnement und Kontingent“Diese Antworten enthalten außerdem offers (Lösungsmöglichkeiten: eine Testversion, ein Abonnement, ein Upgrade, ein Paket oder das Hinzufügen einer Karte – jeweils mit einem CHAMPREP Abrechnungslink) und, sofern ein Kontingent oder eine Funktion gemeint ist, feature.
| Code | HTTP | Wiederholbar | Bedeutung |
|---|---|---|---|
RTC_SUBSCRIPTION_REQUIRED | 402 | nein | Das Konto verfügt über kein RTC-Abonnement, keine Testversion und kein inbegriffenes Kontingent (siehe offers). |
RTC_PAYMENT_REQUIRED | 402 | nein | Eine unbezahlte Rechnung blockiert RTC; begleichen Sie diese bitte in „BillingCHAMPREP“. |
RTC_ACCESS_DENIED | 403 | nein | Eine Richtlinie der Organisation, des Teams oder der Plattform verweigert RTC (reasonCode (gibt an, welche). |
RTC_ALLOWANCE_EXHAUSTED | 402 | nein | Ein RTC-Kontingent des Abonnements ist aufgebraucht (feature gibt an, welche; siehe offers). |
RTC_FEATURE_NOT_IN_PLAN | 403 | nein | Das Abonnement umfasst diese Funktion nicht (siehe offers). |
RTC_PLAN_LIMIT | 403 | nein | Ein Limit des Abonnements wurde erreicht (Raumgröße, gleichzeitig geöffnete Räume). |
PAYMENT_METHOD_REQUIRED | 402 | nein | Für die Testphase ist eine gespeicherte Karte im kostenpflichtigen Arbeitsbereich erforderlich (siehe offers). |
TRIAL_ALREADY_USED | 409 | nein | Die kostenlose Testversion wurde von diesem Konto bereits in Anspruch genommen. |
TRIAL_NOT_ALLOWED | 403 | nein | Dieses Konto kann die kostenlose Testphase nicht starten. |
TRIAL_UNAVAILABLE | 409 | nein | Die kostenlose Testversion ist nicht verfügbar. |
ALREADY_SUBSCRIBED | 409 | nein | Das Konto verfügt bereits über ein RTC-Abonnement. |
PRIMARY_TOKEN_REQUIRED | 401 | nein | Zum Starten einer Testphase ist die Konsolensitzung des Kontoinhabers erforderlich. |
PRIMARY_TOKEN_INVALID | 401 | nein | Die Konsolensitzung ist für den Start einer Testphase nicht gültig; melden Sie sich bitte erneut an. |
PRIMARY_TOKEN_MISMATCH | 403 | nein | Nur der Kontoinhaber kann diese Testphase starten. |
Paginierung und Idempotenz
Abschnitt betitelt „Paginierung und Idempotenz“| Code | HTTP | Wiederholbar | Bedeutung |
|---|---|---|---|
INVALID_CURSOR | 400 | nein | Die cursor ist fehlerhaft oder gehört zu einer anderen Liste. |
IDEMPOTENCY_KEY_INVALID | 400 | nein | Die Idempotency-Key Der Header ist fehlerhaft. |
IDEMPOTENCY_KEY_REUSED | 409 | nein | Die Idempotency-Key wurde bereits in einer anderen Anfrage verwendet. |
IDEMPOTENCY_IN_PROGRESS | 409 | Ja | Die erste Anfrage mit diesem Idempotency-Key läuft noch. |
Räume, Teilnehmer-Token und Medien
Abschnitt betitelt „Räume, Teilnehmer-Token und Medien“| Code | HTTP | Wiederholbar | Bedeutung |
|---|---|---|---|
ROOM_EXTERNAL_REF_CONFLICT | 409 | nein | Ein offener Raum des Projekts verwendet dies bereits externalRef. |
ROOM_FULL | 409 | nein | Der Raum hat seine Teilnehmergrenze erreicht. |
ROOM_LOCKED | 409 | nein | Der Raum ist gesperrt; nur Gastgeber können beitreten. |
ROOM_ALLOWANCE_UNAVAILABLE | 503 | Ja | Die zulässige Teilnehmeranzahl für den Raum konnte nicht ausgelesen werden. |
PARTICIPANT_BANNED | 409 | nein | Diese Identität wurde aus dem Raum ausgeschlossen. |
PARTICIPANT_REMOVED | 403 | nein | Dieser Teilnehmer wurde aus dem Raum entfernt. |
MEDIA_CAPACITY | 503 | Ja | Derzeit verfügt kein Medienknoten über freie Kapazitäten hierfür; versuchen Sie es später erneut. |
MEDIA_NODE_UNAVAILABLE | 503 | Ja | Der Medienknoten des Raums ist nicht verfügbar; bitte versuchen Sie es erneut. |
MEDIA_UNAVAILABLE | 503 | Ja | Der Mediendienst ist nicht verfügbar; bitte versuchen Sie es erneut. |
HOST_MUTED | 403 | nein | Ein Gastgeber hat diese Quelle stummgeschaltet. |
DATA_NOT_PERMITTED | 403 | nein | Der Teilnehmer darf keine App-Nachrichten senden. |
MESSAGE_TOO_LARGE | 400 | nein | Die App-Nachricht ist zu groß. |
MESSAGE_RATE_LIMITED | 429 | Ja | Zu viele App-Nachrichten von diesem Teilnehmer. |
ROOM_MESSAGE_RATE_LIMITED | 429 | Ja | Zu viele App-Nachrichten in diesem Raum. |
RESERVED_TOPIC | 400 | nein | Das Thema der App-Nachricht ist reserviert. |
INVALID_RECIPIENTS | 400 | nein | Die Empfänger der App-Nachricht sind ungültig. |
RESUME_REFUSED | 403 | nein | Die Sitzung kann nicht fortgesetzt werden. |
RESUME_UNAVAILABLE | 503 | Ja | Die Wiederaufnahme ist vorübergehend nicht verfügbar. |
FIRST_PARTY | 409 | nein | Reserviert für eigene Produkte CHAMPREPvon . |
FIRST_PARTY_NOT_READY | 503 | Ja | Der First-Party-Mandant wurde noch nicht bereitgestellt. |
Join-Token und Projekt-Signaturschlüssel
Abschnitt betitelt „Join-Token und Projekt-Signaturschlüssel“| Code | HTTP | Wiederholbar | Bedeutung |
|---|---|---|---|
JOIN_GRANT_INVALID | 401 | nein | Das Join-Token ist fehlerhaft, abgelaufen, falsch signiert oder sein Signaturschlüssel wurde widerrufen. |
JOIN_GRANT_USED | 409 | nein | Dieses Teilnahmetoken wurde bereits ausgetauscht (es ist nur einmal verwendbar). |
SIGNING_KEY_LIMIT | 409 | nein | Das Projekt verfügt bereits über die maximale Anzahl aktiver Signaturschlüssel. |
SIGNING_KEY_INVALID | 400 | nein | Der öffentliche Schlüssel ist kein gültiger P-256-JWK. |
Aufzeichnungen, Transkripte und Untertitel
Abschnitt betitelt „Aufzeichnungen, Transkripte und Untertitel“| Code | HTTP | Wiederholbar | Bedeutung |
|---|---|---|---|
COMPOSITE_UNAVAILABLE | 400 | nein | Eine zusammengesetzte Aufzeichnung ist nicht verfügbar. |
DELETE_NOT_AVAILABLE | 403 | nein | Aufzeichnungen können von Kunden nicht gelöscht werden (wird nicht mehr gesendet: DELETE /v1/recordings/:id (Die Aufnahme wird in den Papierkorb verschoben und nach 30 Tagen automatisch gelöscht.) |
RECORDING_ACTIVE | 409 | nein | Die Aufzeichnung läuft noch. |
RECORDING_SETTLING | 409 | Ja | Die Aufzeichnung wird noch gespeichert. |
RECORDING_NOT_READY | 409 | nein | Die Aufzeichnung ist noch nicht abgeschlossen (für die Zustellung ist eine fertige Aufzeichnung erforderlich). |
RECORDING_NOT_IN_TRASH | 409 | nein | Nur eine Aufnahme im Papierkorb kann endgültig gelöscht werden; löschen Sie diese bitte zunächst. |
RECORDING_PURGED | 409 | nein | Die Aufzeichnung wurde endgültig gelöscht (aus dem Papierkorb oder durch einen Administrator) und kann nicht wiederhergestellt werden. |
CONFIRM_PURGE_REQUIRED | 400 | nein | Zum Verkleinern des Papierkorb-Fensters ist „confirmPurge: true“ erforderlich. |
TRANSCRIPTION_UNAVAILABLE | 400 | nein | Für dieses Konto sind keine Transkripte verfügbar. |
TRANSCRIPT_EXISTS | 409 | nein | Ein Transkript dieser Aufzeichnung existiert bereits oder wird gerade erstellt. |
NO_AUDIO | 409 | nein | Die Aufzeichnung enthält kein Audio, das transkribiert werden könnte. |
TRANSCRIPT_NOT_READY | 409 | Ja | Das Transkript ist noch nicht fertiggestellt; nur ein fertiges Transkript kann als VTT, SRT oder TXT exportiert werden. |
TRANSCRIPT_RUNNING | 409 | nein | Die Transkription wird bereits erstellt und kann nicht abgebrochen werden. |
TRANSCRIPT_NOT_CANCELLABLE | 409 | nein | Nur ein Transkript, das noch nicht gestartet wurde, kann abgebrochen werden. |
WINDOW_TOO_LONG | 400 | nein | Das angeforderte Zeitfenster ist zu lang. |
SUMMARY_TIMEOUT | 503 | Ja | Die Zusammenfassung hat zu lange gedauert; versuchen Sie es erneut. |
CAPTIONS_BUSY | 503 | Ja | Die Kapazität für Live-Untertitel ist ausgeschöpft; versuchen Sie es später erneut. |
CAPTIONS_LANGUAGE_LIMIT | 409 | nein | In diesem Raum sind zu viele Untertitel-Sprachen vorhanden. |
CAPTIONS_NOT_PERMITTED | 403 | nein | Der Teilnehmer darf möglicherweise keine Untertitel verwenden. |
INVALID_LANGUAGE | 400 | nein | Der Sprachcode wird nicht unterstützt. |
Speicherplatz für Aufzeichnungen
Abschnitt betitelt „Speicherplatz für Aufzeichnungen“| Code | HTTP | Wiederholbar | Bedeutung |
|---|---|---|---|
DESTINATION_LIMIT | 409 | nein | Die Organisation hat die maximale Anzahl an Speicherzielen erreicht. |
DESTINATION_ADMIN_DISABLED | 403 | nein | CHAMPREP Der Support hat dieses Speicherziel deaktiviert; es kann vom Kunden nicht wieder aktiviert werden. |
ENDPOINT_NOT_ALLOWED | 400 | nein | Der S3-kompatible Endpunkt ist nicht zulässig (HTTPS auf Port 443 ausschließlich an eine öffentliche Adresse). |
REDELIVERY_LIMIT | 429 | Ja | Die Aufzeichnung wurde kürzlich erneut gesendet, oder die Organisation hat in dieser Stunde erneut zu viele gesendet; versuchen Sie es später erneut. |
NO_ACTIVE_DESTINATION | 409 | nein | Für diese Aufzeichnung gilt kein aktives Speicherziel. |
EGRESS_UNAVAILABLE | 503 | Ja | Die Abrechnungsstelle konnte für diesen Download nicht erreicht werden; versuchen Sie es in Kürze erneut. |
DELIVERY_NOT_CONFIGURED | 503 | nein | AWS-Rollen als Speicherziele sind noch nicht verfügbar; verwenden Sie S3-kompatible Schlüssel (Code und Nachricht wurden gesendet). |
CREDENTIALS_UNAVAILABLE | 503 | nein | Das Speichern von Zielschlüsseln ist noch nicht verfügbar; verwenden Sie eine AWS-Rolle. |
Webhooks
Abschnitt betitelt „Webhooks“| Code | HTTP | Wiederholbar | Bedeutung |
|---|---|---|---|
WEBHOOK_NOT_CONFIGURED | 409 | nein | Es ist kein Webhook-Endpunkt konfiguriert. |
WEBHOOK_URL_INVALID | 400 | nein | Die Webhook-URL ist kein öffentlicher HTTPS-Endpunkt auf Port 443 außerhalb der DomänenCHAMPREP. |
WEBHOOK_ENDPOINT_LIMIT | 409 | nein | Die Anzahl der Webhook-Endpunkte des Tarifs ist erreicht (details.limit, details.used). |
WEBHOOK_ENDPOINT_NOT_FOUND | 404 | nein | Der Webhook-Endpunkt existiert nicht. |
WEBHOOK_ENDPOINT_DISABLED | 409 | nein | Der Webhook-Endpunkt ist deaktiviert; aktivieren Sie ihn bitte zunächst. |
WEBHOOK_ENDPOINT_ADMIN_DISABLED | 403 | nein | CHAMPREP Der Support hat den Webhook-Endpunkt deaktiviert; wenden Sie sich bitte an den Support. |
WEBHOOK_URL_ADMIN_DISABLED | 403 | nein | CHAMPREP Der Support hat diese Webhook-URL deaktiviert; sie kann nicht erneut hinzugefügt werden. Wenden Sie sich bitte an den Support. |
WEBHOOK_EVENT_UNKNOWN | 400 | nein | Ein Ereignisfilter passt zu keinem bekannten Ereignistyp (details.patterns). |
REPLAY_LIMIT | 409 | nein | Diese Übermittlung wurde zu oft wiederholt. |
REPLAY_QUOTA | 429 | Ja | Zu viele Wiederholungen; bitte warten, bis Retry-After Sekunden. |
DELIVERY_IN_PROGRESS | 409 | Ja | Die Zustellung erfolgt gerade. |
Whiteboards
Abschnitt betitelt „Whiteboards“| Code | HTTP | Wiederholbar | Bedeutung |
|---|---|---|---|
WHITEBOARD_UNAVAILABLE | 503 | Ja | Der Whiteboard-Dienst ist nicht verfügbar. |
WHITEBOARD_DISABLED | 403 | nein | Whiteboards sind für dieses Konto deaktiviert. |
WHITEBOARD_ARCHIVED | 409 | nein | Das Whiteboard ist archiviert. |
WHITEBOARD_LIMIT | 409 | nein | Der Raum hat die maximale Anzahl an Whiteboards erreicht. |
WHITEBOARD_QUOTA | 402 | nein | Das Whiteboard-Kontingent ist aufgebraucht. |
WHITEBOARD_FILE_INVALID | 422 | nein | Die Whiteboard-Datei konnte nicht gelesen werden. |
WHITEBOARD_FILE_LIMIT | 409 | nein | Das Whiteboard hat die maximale Anzahl an Dateien erreicht. |
WHITEBOARD_FILE_PENDING | 409 | Ja | Der Upload der Whiteboard-Datei ist noch nicht abgeschlossen. |
WHITEBOARD_FILE_SIZE | 400 | nein | Die angegebene Dateigröße ist ungültig. |
WHITEBOARD_FILE_TOO_LARGE | 413 | nein | Die Whiteboard-Datei ist zu groß. |
WHITEBOARD_FILE_TYPE | 415 | nein | Der Dateityp „Whiteboard“ ist nicht zulässig. |
SNAPSHOT_TOO_LARGE | 413 | nein | Der Whiteboard-Schnappschuss ist zu groß, um zurückgesendet zu werden. |
Fernsteuerung
Abschnitt betitelt „Fernsteuerung“| Code | HTTP | Wiederholbar | Bedeutung |
|---|---|---|---|
RC_BLOCKED | 403 | nein | Die Fernsteuerung ist gesperrt. |
RC_CLIPBOARD_OFF | 403 | nein | Die Freigabe der Zwischenablage ist deaktiviert. |
RC_CLIPBOARD_TOO_LARGE | 413 | nein | Der Inhalt der Zwischenablage ist zu groß. |
RC_CONFLICT | 409 | nein | Eine weitere Fernsteuerungsanfrage steht in Konflikt. |
RC_INVALID_REQUEST | 400 | nein | Die Fernsteuerungsanfrage ist ungültig. |
RC_NOT_PERMITTED | 403 | nein | Die Fernsteuerung ist nicht zulässig. |
RC_NO_BUDGET | 402 | nein | Es ist kein Fernsteuerungskontingent mehr verfügbar. |
RC_PENDING | 409 | nein | Eine Fernsteuerungsanfrage ist bereits anhängig. |
RC_RATE_LIMITED | 429 | Ja | Zu viele Fernsteuerungsanfragen. |
RC_REAUTH_REQUIRED | 401 | nein | Bitte authentifizieren Sie sich erneut, um die Fernsteuerung fortzusetzen. |
RC_SHARER_BUSY | 409 | nein | Der Freigebende wird bereits ferngesteuert. |
RC_UNAVAILABLE | 404 | nein | Die Fernsteuerung ist nicht verfügbar. |
RC_WIDEN_REFUSED | 403 | nein | Die Fernsteuerungsberechtigung kann nicht erweitert werden. |
Telemetrie
Abschnitt betitelt „Telemetrie“| Code | HTTP | Wiederholbar | Bedeutung |
|---|---|---|---|
INVALID_TELEMETRY | 400 | nein | Das Telemetrie-Beispiel ist ungültig. |
TELEMETRY_RATE_LIMITED | 429 | Ja | Zu viele Telemetrie-Datenpunkte. |