Zum Inhalt springen
Documentation

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.

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:

Terminal-Fenster
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"
}
}
FeldBedeutung
codeStabiler Code aus dem Katalog
messageFür Menschen lesbare Erklärung; bitte nicht analysieren
detailsOptionaler strukturierter Kontext, zum Beispiel limit und usedoder issues (die ungültigen Felder) für INVALID_REQUEST
requestIdDie ID dieser Anfrage, die ebenfalls als X-Request-Id
retryabletrue kann bei einer späteren Wiederholung derselben Anfrage erfolgreich sein
docUrlLink 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.

HeaderWannBedeutung
X-Request-IdJede AntwortEindeutige ID der Anfrage. Geben Sie diese an, wenn Sie sich an den Support wenden.
X-Error-CodeJeder FehlerDer stabile Code, in beiden Antwortformaten
Retry-After429und einige 503Sekunden, die vor einem erneuten Versuch abgewartet werden sollen
X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-ResetAuthentifizierte AntwortenSiehe Ratenbegrenzungen

  • retryable: false (4xx außer 429): 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 von Retry-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.
  • 404 gilt auch für Ressourcen, die einer anderen Person gehören. Überprüfen Sie niemals die Identifikatoren anderer Kunden.

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)“
CodeHTTPWiederholbarBedeutung
INVALID_REQUEST400neinDie Anfrage ist fehlerhaft oder ein Feld ist ungültig (details.issues listet die Felder auf).
UNAUTHENTICATED401neinFehlende, ungültige oder abgelaufene Anmeldedaten.
PAYMENT_REQUIRED402neinEs ist eine Zahlung fällig, bevor diese Funktion genutzt werden kann.
FORBIDDEN403neinDie Anmeldedaten sind gültig, aber für diese Aktion nicht berechtigt.
NOT_FOUND404neinDie Ressource existiert nicht oder ist für diese Anmeldedaten nicht sichtbar.
CONFLICT409neinDie Anfrage steht im Widerspruch zum aktuellen Status.
PAYLOAD_TOO_LARGE413neinDer Anfragetext ist zu groß.
UNSUPPORTED_MEDIA_TYPE415neinDer Inhaltstyp wird nicht akzeptiert.
RANGE_NOT_SATISFIABLE416neinDer angeforderte Byte-Bereich ist ungültig oder nicht verfügbar.
UNPROCESSABLE422neinDer Inhalt wurde verstanden, kann jedoch nicht verarbeitet werden.
RATE_LIMITED429JaZu viele Anfragen; warten Sie, bis Retry-After Sekunden.
INTERNAL500JaUnerwarteter Serverfehler; versuchen Sie es später erneut.
SERVICE_UNAVAILABLE503JaVorübergehend nicht verfügbar; versuchen Sie es mit einer Wartezeit erneut.

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.

CodeHTTPWiederholbarBedeutung
RTC_SUBSCRIPTION_REQUIRED402neinDas Konto verfügt über kein RTC-Abonnement, keine Testversion und kein inbegriffenes Kontingent (siehe offers).
RTC_PAYMENT_REQUIRED402neinEine unbezahlte Rechnung blockiert RTC; begleichen Sie diese bitte in „BillingCHAMPREP“.
RTC_ACCESS_DENIED403neinEine Richtlinie der Organisation, des Teams oder der Plattform verweigert RTC (reasonCode (gibt an, welche).
RTC_ALLOWANCE_EXHAUSTED402neinEin RTC-Kontingent des Abonnements ist aufgebraucht (feature gibt an, welche; siehe offers).
RTC_FEATURE_NOT_IN_PLAN403neinDas Abonnement umfasst diese Funktion nicht (siehe offers).
RTC_PLAN_LIMIT403neinEin Limit des Abonnements wurde erreicht (Raumgröße, gleichzeitig geöffnete Räume).
PAYMENT_METHOD_REQUIRED402neinFür die Testphase ist eine gespeicherte Karte im kostenpflichtigen Arbeitsbereich erforderlich (siehe offers).
TRIAL_ALREADY_USED409neinDie kostenlose Testversion wurde von diesem Konto bereits in Anspruch genommen.
TRIAL_NOT_ALLOWED403neinDieses Konto kann die kostenlose Testphase nicht starten.
TRIAL_UNAVAILABLE409neinDie kostenlose Testversion ist nicht verfügbar.
ALREADY_SUBSCRIBED409neinDas Konto verfügt bereits über ein RTC-Abonnement.
PRIMARY_TOKEN_REQUIRED401neinZum Starten einer Testphase ist die Konsolensitzung des Kontoinhabers erforderlich.
PRIMARY_TOKEN_INVALID401neinDie Konsolensitzung ist für den Start einer Testphase nicht gültig; melden Sie sich bitte erneut an.
PRIMARY_TOKEN_MISMATCH403neinNur der Kontoinhaber kann diese Testphase starten.

CodeHTTPWiederholbarBedeutung
INVALID_CURSOR400neinDie cursor ist fehlerhaft oder gehört zu einer anderen Liste.
IDEMPOTENCY_KEY_INVALID400neinDie Idempotency-Key Der Header ist fehlerhaft.
IDEMPOTENCY_KEY_REUSED409neinDie Idempotency-Key wurde bereits in einer anderen Anfrage verwendet.
IDEMPOTENCY_IN_PROGRESS409JaDie erste Anfrage mit diesem Idempotency-Key läuft noch.

CodeHTTPWiederholbarBedeutung
ROOM_EXTERNAL_REF_CONFLICT409neinEin offener Raum des Projekts verwendet dies bereits externalRef.
ROOM_FULL409neinDer Raum hat seine Teilnehmergrenze erreicht.
ROOM_LOCKED409neinDer Raum ist gesperrt; nur Gastgeber können beitreten.
ROOM_ALLOWANCE_UNAVAILABLE503JaDie zulässige Teilnehmeranzahl für den Raum konnte nicht ausgelesen werden.
PARTICIPANT_BANNED409neinDiese Identität wurde aus dem Raum ausgeschlossen.
PARTICIPANT_REMOVED403neinDieser Teilnehmer wurde aus dem Raum entfernt.
MEDIA_CAPACITY503JaDerzeit verfügt kein Medienknoten über freie Kapazitäten hierfür; versuchen Sie es später erneut.
MEDIA_NODE_UNAVAILABLE503JaDer Medienknoten des Raums ist nicht verfügbar; bitte versuchen Sie es erneut.
MEDIA_UNAVAILABLE503JaDer Mediendienst ist nicht verfügbar; bitte versuchen Sie es erneut.
HOST_MUTED403neinEin Gastgeber hat diese Quelle stummgeschaltet.
DATA_NOT_PERMITTED403neinDer Teilnehmer darf keine App-Nachrichten senden.
MESSAGE_TOO_LARGE400neinDie App-Nachricht ist zu groß.
MESSAGE_RATE_LIMITED429JaZu viele App-Nachrichten von diesem Teilnehmer.
ROOM_MESSAGE_RATE_LIMITED429JaZu viele App-Nachrichten in diesem Raum.
RESERVED_TOPIC400neinDas Thema der App-Nachricht ist reserviert.
INVALID_RECIPIENTS400neinDie Empfänger der App-Nachricht sind ungültig.
RESUME_REFUSED403neinDie Sitzung kann nicht fortgesetzt werden.
RESUME_UNAVAILABLE503JaDie Wiederaufnahme ist vorübergehend nicht verfügbar.
FIRST_PARTY409neinReserviert für eigene Produkte CHAMPREPvon .
FIRST_PARTY_NOT_READY503JaDer First-Party-Mandant wurde noch nicht bereitgestellt.

CodeHTTPWiederholbarBedeutung
JOIN_GRANT_INVALID401neinDas Join-Token ist fehlerhaft, abgelaufen, falsch signiert oder sein Signaturschlüssel wurde widerrufen.
JOIN_GRANT_USED409neinDieses Teilnahmetoken wurde bereits ausgetauscht (es ist nur einmal verwendbar).
SIGNING_KEY_LIMIT409neinDas Projekt verfügt bereits über die maximale Anzahl aktiver Signaturschlüssel.
SIGNING_KEY_INVALID400neinDer öffentliche Schlüssel ist kein gültiger P-256-JWK.

CodeHTTPWiederholbarBedeutung
COMPOSITE_UNAVAILABLE400neinEine zusammengesetzte Aufzeichnung ist nicht verfügbar.
DELETE_NOT_AVAILABLE403neinAufzeichnungen 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_ACTIVE409neinDie Aufzeichnung läuft noch.
RECORDING_SETTLING409JaDie Aufzeichnung wird noch gespeichert.
RECORDING_NOT_READY409neinDie Aufzeichnung ist noch nicht abgeschlossen (für die Zustellung ist eine fertige Aufzeichnung erforderlich).
RECORDING_NOT_IN_TRASH409neinNur eine Aufnahme im Papierkorb kann endgültig gelöscht werden; löschen Sie diese bitte zunächst.
RECORDING_PURGED409neinDie Aufzeichnung wurde endgültig gelöscht (aus dem Papierkorb oder durch einen Administrator) und kann nicht wiederhergestellt werden.
CONFIRM_PURGE_REQUIRED400neinZum Verkleinern des Papierkorb-Fensters ist „confirmPurge: true“ erforderlich.
TRANSCRIPTION_UNAVAILABLE400neinFür dieses Konto sind keine Transkripte verfügbar.
TRANSCRIPT_EXISTS409neinEin Transkript dieser Aufzeichnung existiert bereits oder wird gerade erstellt.
NO_AUDIO409neinDie Aufzeichnung enthält kein Audio, das transkribiert werden könnte.
TRANSCRIPT_NOT_READY409JaDas Transkript ist noch nicht fertiggestellt; nur ein fertiges Transkript kann als VTT, SRT oder TXT exportiert werden.
TRANSCRIPT_RUNNING409neinDie Transkription wird bereits erstellt und kann nicht abgebrochen werden.
TRANSCRIPT_NOT_CANCELLABLE409neinNur ein Transkript, das noch nicht gestartet wurde, kann abgebrochen werden.
WINDOW_TOO_LONG400neinDas angeforderte Zeitfenster ist zu lang.
SUMMARY_TIMEOUT503JaDie Zusammenfassung hat zu lange gedauert; versuchen Sie es erneut.
CAPTIONS_BUSY503JaDie Kapazität für Live-Untertitel ist ausgeschöpft; versuchen Sie es später erneut.
CAPTIONS_LANGUAGE_LIMIT409neinIn diesem Raum sind zu viele Untertitel-Sprachen vorhanden.
CAPTIONS_NOT_PERMITTED403neinDer Teilnehmer darf möglicherweise keine Untertitel verwenden.
INVALID_LANGUAGE400neinDer Sprachcode wird nicht unterstützt.

CodeHTTPWiederholbarBedeutung
DESTINATION_LIMIT409neinDie Organisation hat die maximale Anzahl an Speicherzielen erreicht.
DESTINATION_ADMIN_DISABLED403neinCHAMPREP Der Support hat dieses Speicherziel deaktiviert; es kann vom Kunden nicht wieder aktiviert werden.
ENDPOINT_NOT_ALLOWED400neinDer S3-kompatible Endpunkt ist nicht zulässig (HTTPS auf Port 443 ausschließlich an eine öffentliche Adresse).
REDELIVERY_LIMIT429JaDie 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_DESTINATION409neinFür diese Aufzeichnung gilt kein aktives Speicherziel.
EGRESS_UNAVAILABLE503JaDie Abrechnungsstelle konnte für diesen Download nicht erreicht werden; versuchen Sie es in Kürze erneut.
DELIVERY_NOT_CONFIGURED503neinAWS-Rollen als Speicherziele sind noch nicht verfügbar; verwenden Sie S3-kompatible Schlüssel (Code und Nachricht wurden gesendet).
CREDENTIALS_UNAVAILABLE503neinDas Speichern von Zielschlüsseln ist noch nicht verfügbar; verwenden Sie eine AWS-Rolle.
CodeHTTPWiederholbarBedeutung
WEBHOOK_NOT_CONFIGURED409neinEs ist kein Webhook-Endpunkt konfiguriert.
WEBHOOK_URL_INVALID400neinDie Webhook-URL ist kein öffentlicher HTTPS-Endpunkt auf Port 443 außerhalb der DomänenCHAMPREP.
WEBHOOK_ENDPOINT_LIMIT409neinDie Anzahl der Webhook-Endpunkte des Tarifs ist erreicht (details.limit, details.used).
WEBHOOK_ENDPOINT_NOT_FOUND404neinDer Webhook-Endpunkt existiert nicht.
WEBHOOK_ENDPOINT_DISABLED409neinDer Webhook-Endpunkt ist deaktiviert; aktivieren Sie ihn bitte zunächst.
WEBHOOK_ENDPOINT_ADMIN_DISABLED403neinCHAMPREP Der Support hat den Webhook-Endpunkt deaktiviert; wenden Sie sich bitte an den Support.
WEBHOOK_URL_ADMIN_DISABLED403neinCHAMPREP Der Support hat diese Webhook-URL deaktiviert; sie kann nicht erneut hinzugefügt werden. Wenden Sie sich bitte an den Support.
WEBHOOK_EVENT_UNKNOWN400neinEin Ereignisfilter passt zu keinem bekannten Ereignistyp (details.patterns).
REPLAY_LIMIT409neinDiese Übermittlung wurde zu oft wiederholt.
REPLAY_QUOTA429JaZu viele Wiederholungen; bitte warten, bis Retry-After Sekunden.
DELIVERY_IN_PROGRESS409JaDie Zustellung erfolgt gerade.
CodeHTTPWiederholbarBedeutung
WHITEBOARD_UNAVAILABLE503JaDer Whiteboard-Dienst ist nicht verfügbar.
WHITEBOARD_DISABLED403neinWhiteboards sind für dieses Konto deaktiviert.
WHITEBOARD_ARCHIVED409neinDas Whiteboard ist archiviert.
WHITEBOARD_LIMIT409neinDer Raum hat die maximale Anzahl an Whiteboards erreicht.
WHITEBOARD_QUOTA402neinDas Whiteboard-Kontingent ist aufgebraucht.
WHITEBOARD_FILE_INVALID422neinDie Whiteboard-Datei konnte nicht gelesen werden.
WHITEBOARD_FILE_LIMIT409neinDas Whiteboard hat die maximale Anzahl an Dateien erreicht.
WHITEBOARD_FILE_PENDING409JaDer Upload der Whiteboard-Datei ist noch nicht abgeschlossen.
WHITEBOARD_FILE_SIZE400neinDie angegebene Dateigröße ist ungültig.
WHITEBOARD_FILE_TOO_LARGE413neinDie Whiteboard-Datei ist zu groß.
WHITEBOARD_FILE_TYPE415neinDer Dateityp „Whiteboard“ ist nicht zulässig.
SNAPSHOT_TOO_LARGE413neinDer Whiteboard-Schnappschuss ist zu groß, um zurückgesendet zu werden.

CodeHTTPWiederholbarBedeutung
RC_BLOCKED403neinDie Fernsteuerung ist gesperrt.
RC_CLIPBOARD_OFF403neinDie Freigabe der Zwischenablage ist deaktiviert.
RC_CLIPBOARD_TOO_LARGE413neinDer Inhalt der Zwischenablage ist zu groß.
RC_CONFLICT409neinEine weitere Fernsteuerungsanfrage steht in Konflikt.
RC_INVALID_REQUEST400neinDie Fernsteuerungsanfrage ist ungültig.
RC_NOT_PERMITTED403neinDie Fernsteuerung ist nicht zulässig.
RC_NO_BUDGET402neinEs ist kein Fernsteuerungskontingent mehr verfügbar.
RC_PENDING409neinEine Fernsteuerungsanfrage ist bereits anhängig.
RC_RATE_LIMITED429JaZu viele Fernsteuerungsanfragen.
RC_REAUTH_REQUIRED401neinBitte authentifizieren Sie sich erneut, um die Fernsteuerung fortzusetzen.
RC_SHARER_BUSY409neinDer Freigebende wird bereits ferngesteuert.
RC_UNAVAILABLE404neinDie Fernsteuerung ist nicht verfügbar.
RC_WIDEN_REFUSED403neinDie Fernsteuerungsberechtigung kann nicht erweitert werden.

CodeHTTPWiederholbarBedeutung
INVALID_TELEMETRY400neinDas Telemetrie-Beispiel ist ungültig.
TELEMETRY_RATE_LIMITED429JaZu viele Telemetrie-Datenpunkte.