Erreurs RTC
Chaque erreur RTC comporte un code stable et lisible par machine code. Basez-vous sur le code, jamais sur le texte du message : les messages peuvent être reformulés, tandis que les codes ne sont jamais renommés ni réutilisés avec une autre signification.
Deux formats de réponse
Section intitulée « Deux formats de réponse »Par défaut. Sans en-tête de version, les erreurs conservent leur format d’origine, de sorte que les intégrations existantes ne sont pas affectées :
{ "error": "Your plan allows 2 webhook endpoints", "code": "WEBHOOK_ENDPOINT_LIMIT" }code est présent sur les erreurs dotées d’un code spécifique. Les anciennes erreurs peuvent uniquement porter error; le X-Error-Code L’en-tête indique toujours le code.
Enveloppe structurée. Envoyer RTC-Version: 2026-11-01 avec une requête visant à recevoir l’enveloppe structurée :
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" }}| Champ | Signification |
|---|---|
code | Code stable issu du catalogue |
message | Explication lisible par l’utilisateur ; ne l’analysez pas |
details | Contexte structuré facultatif, par exemple limit et used, ou issues (les champs non valides) pour INVALID_REQUEST |
requestId | L’identifiant de cette requête, également envoyé sous la forme X-Request-Id |
retryable | true : une nouvelle tentative ultérieure de la même requête peut aboutir |
docUrl | Lien vers l’entrée de ce code ci-dessous |
La réponse reprend la version qu’elle a appliquée dans le RTC-Version . Une date antérieure à 2026-11-01 conserve la structure par défaut. Voir gestion des versions.
En-têtes HTTP sur chaque réponse
Section intitulée « En-têtes HTTP sur chaque réponse »| En-tête | Quand | Signification |
|---|---|---|
X-Request-Id | Chaque réponse | Identifiant unique de la requête. Veuillez l’indiquer lorsque vous contactez le service d’assistance. |
X-Error-Code | Chaque erreur | Le code stable, dans les deux formats de réponse |
Retry-After | 429, et certains 503 | Nombre de secondes à attendre avant de réessayer |
X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset | Réponses authentifiées | Voir limites de débit |
Gestion des erreurs
Section intitulée « Gestion des erreurs »retryable: false(4xxautre que429) : corrigez d’abord la requête, les identifiants, le plan ou l’état. La répéter sans modification donne la même réponse.retryable: true: réessayez avec un recul exponentiel et une variation de délai, en respectantRetry-After. Ne réessayez les écritures que lorsque l’opération est idempotente ou après avoir validé son résultat.401: les identifiants sont manquants, périmés ou révoqués.403: les identifiants sont valides mais ne disposent pas de périmètre, d’accès au projet ou de droits liés au forfait.404couvre également les ressources appartenant à un tiers. Ne jamais interroger les identifiants d’autres clients.
Catalogue des codes
Section intitulée « Catalogue des codes »GET /v1/error-codes (sans authentification) renvoie le catalogue actuel sous la forme
{ "codes": [{ "code", "status", "retryable", "description" }] }. De nouveaux codes peuvent être ajoutés à tout moment ; traitez un code inconnu comme le code générique de son statut HTTP.
Codes génériques (un par statut HTTP, utilisés lorsqu’aucun code spécifique ne s’applique)
Section intitulée « Codes génériques (un par statut HTTP, utilisés lorsqu’aucun code spécifique ne s’applique) »| Code | HTTP | Réessayable | Signification |
|---|---|---|---|
INVALID_REQUEST | 400 | non | La requête est mal formée ou un champ n’est pas valide (details.issues répertorie les champs). |
UNAUTHENTICATED | 401 | non | Identifiants manquants, non valides ou périmés. |
PAYMENT_REQUIRED | 402 | non | Un paiement est dû avant que cette fonctionnalité puisse être utilisée. |
FORBIDDEN | 403 | non | Les identifiants sont valides, mais l’accès à cette fonctionnalité n’est pas autorisé. |
NOT_FOUND | 404 | non | La ressource n’existe pas ou n’est pas visible pour cet identifiant. |
CONFLICT | 409 | non | La demande est en conflit avec l’état actuel. |
PAYLOAD_TOO_LARGE | 413 | non | Le corps de la requête est trop volumineux. |
UNSUPPORTED_MEDIA_TYPE | 415 | non | Le type de contenu n’est pas accepté. |
RANGE_NOT_SATISFIABLE | 416 | non | La plage d’octets demandée n’est pas valide ou n’est pas disponible. |
UNPROCESSABLE | 422 | non | Le contenu a été compris mais ne peut pas être traité. |
RATE_LIMITED | 429 | oui | Trop de demandes ; veuillez patienter jusqu’à Retry-After secondes. |
INTERNAL | 500 | oui | Erreur serveur inattendue ; veuillez réessayer plus tard. |
SERVICE_UNAVAILABLE | 503 | oui | Temporairement indisponible ; réessayez en respectant un délai d’attente. |
Abonnement et quota
Section intitulée « Abonnement et quota »Ces réponses comportent également offers (solution : une période d’essai, un abonnement, une mise à niveau, un pack ou l’ajout d’une carte, chacun comportant un lien vers la facturationCHAMPREP) et, lorsqu’il s’agit d’un quota ou d’une fonctionnalité, feature.
| Code | HTTP | Réessayable | Signification |
|---|---|---|---|
RTC_SUBSCRIPTION_REQUIRED | 402 | non | Le compte ne dispose d’aucun abonnement RTC, d’aucune période d’essai ni d’aucun quota inclus (voir offers). |
RTC_PAYMENT_REQUIRED | 402 | non | Une facture impayée bloque l’accès au RTC ; réglez-la dans la section « FacturationCHAMPREP ». |
RTC_ACCESS_DENIED | 403 | non | Une politique de l’organisation, de l’équipe ou de la plateforme interdit l’accès au RTC (reasonCode (précise lesquels). |
RTC_ALLOWANCE_EXHAUSTED | 402 | non | Une partie du quota RTC de l’abonnement a été utilisée (feature précise lesquels ; voir offers). |
RTC_FEATURE_NOT_IN_PLAN | 403 | non | L’abonnement ne comprend pas cette fonctionnalité (voir offers). |
RTC_PLAN_LIMIT | 403 | non | Une limite de l’abonnement a été atteinte (taille de la salle, nombre de salles ouvertes simultanément). |
PAYMENT_METHOD_REQUIRED | 402 | non | L’essai nécessite une carte enregistrée dans l’espace de travail payant (voir offers). |
TRIAL_ALREADY_USED | 409 | non | L’essai gratuit a déjà été utilisé par ce compte. |
TRIAL_NOT_ALLOWED | 403 | non | Ce compte ne peut pas démarrer l’essai gratuit. |
TRIAL_UNAVAILABLE | 409 | non | L’essai gratuit n’est pas disponible. |
ALREADY_SUBSCRIBED | 409 | non | Le compte dispose déjà d’un abonnement RTC. |
PRIMARY_TOKEN_REQUIRED | 401 | non | Le lancement d’un procès nécessite la session de la console du titulaire du compte. |
PRIMARY_TOKEN_INVALID | 401 | non | La session de la console n’est pas valide pour démarrer un essai ; veuillez vous reconnecter. |
PRIMARY_TOKEN_MISMATCH | 403 | non | Seul le titulaire du compte peut démarrer cette période d’essai. |
Pagination et idempotence
Section intitulée « Pagination et idempotence »| Code | HTTP | Réessayable | Signification |
|---|---|---|---|
INVALID_CURSOR | 400 | non | Le cursor est mal formé ou appartient à une autre liste. |
IDEMPOTENCY_KEY_INVALID | 400 | non | Le Idempotency-Key L’en-tête est mal formé. |
IDEMPOTENCY_KEY_REUSED | 409 | non | Le Idempotency-Key a été utilisé avec une autre requête. |
IDEMPOTENCY_IN_PROGRESS | 409 | oui | La première requête avec ce Idempotency-Key est toujours en cours d’exécution. |
Salles, jetons de participant et médias
Section intitulée « Salles, jetons de participant et médias »| Code | HTTP | Réessayable | Signification |
|---|---|---|---|
ROOM_EXTERNAL_REF_CONFLICT | 409 | non | Une salle ouverte du projet utilise déjà cette externalRef. |
ROOM_FULL | 409 | non | La salle a atteint sa limite de participants. |
ROOM_LOCKED | 409 | non | La salle est verrouillée ; seuls les hôtes peuvent y accéder. |
ROOM_ALLOWANCE_UNAVAILABLE | 503 | oui | Le nombre maximal de participants autorisés dans la salle n’a pas pu être lu. |
PARTICIPANT_BANNED | 409 | non | Cette identité est bannie de la salle. |
PARTICIPANT_REMOVED | 403 | non | Ce participant a été exclu de la salle. |
MEDIA_CAPACITY | 503 | oui | Aucun nœud multimédia ne dispose actuellement de place pour cela ; veuillez réessayer plus tard. |
MEDIA_NODE_UNAVAILABLE | 503 | oui | Le nœud multimédia de la salle n’est pas disponible ; veuillez réessayer. |
MEDIA_UNAVAILABLE | 503 | oui | Le service multimédia n’est pas disponible ; veuillez réessayer. |
HOST_MUTED | 403 | non | Un animateur a désactivé le son de cette source. |
DATA_NOT_PERMITTED | 403 | non | Le participant n’est pas autorisé à envoyer de messages d’application. |
MESSAGE_TOO_LARGE | 400 | non | Le message d’application est trop volumineux. |
MESSAGE_RATE_LIMITED | 429 | oui | Ce participant a envoyé un trop grand nombre de messages d’application. |
ROOM_MESSAGE_RATE_LIMITED | 429 | oui | Il y a trop de messages d’application dans cette salle. |
RESERVED_TOPIC | 400 | non | Le sujet du message d’application est réservé. |
INVALID_RECIPIENTS | 400 | non | Les destinataires du message d’application ne sont pas valides. |
RESUME_REFUSED | 403 | non | La session ne peut pas être reprise. |
RESUME_UNAVAILABLE | 503 | oui | La fonction de reprise est temporairement indisponible. |
FIRST_PARTY | 409 | non | Réservé aux produits CHAMPREPde . |
FIRST_PARTY_NOT_READY | 503 | oui | Le tenant principal n’est pas encore provisionné. |
Jetons de connexion et clés de signature de projet
Section intitulée « Jetons de connexion et clés de signature de projet »| Code | HTTP | Réessayable | Signification |
|---|---|---|---|
JOIN_GRANT_INVALID | 401 | non | Le jeton de connexion est mal formé, a expiré, est mal signé ou sa clé de signature a été révoquée. |
JOIN_GRANT_USED | 409 | non | Ce jeton de connexion a déjà été utilisé (ils ne sont valables qu’une seule fois). |
SIGNING_KEY_LIMIT | 409 | non | Le projet a déjà atteint le nombre maximal de clés de signature actives. |
SIGNING_KEY_INVALID | 400 | non | La clé publique n’est pas un JWK P-256 valide. |
Enregistrements, transcriptions et sous-titres
Section intitulée « Enregistrements, transcriptions et sous-titres »| Code | HTTP | Réessayable | Signification |
|---|---|---|---|
COMPOSITE_UNAVAILABLE | 400 | non | L’enregistrement composite n’est pas disponible. |
DELETE_NOT_AVAILABLE | 403 | non | Les enregistrements ne peuvent pas être supprimés par les clients (ils ne sont plus envoyés : DELETE /v1/recordings/:id envoie l’enregistrement dans la corbeille ; il sera supprimé automatiquement au bout de 30 jours). |
RECORDING_ACTIVE | 409 | non | L’enregistrement est toujours en cours. |
RECORDING_SETTLING | 409 | oui | L’enregistrement est toujours en cours de stockage. |
RECORDING_NOT_READY | 409 | non | L’enregistrement n’est pas encore terminé (les livraisons nécessitent un enregistrement prêt). |
RECORDING_NOT_IN_TRASH | 409 | non | Seul un enregistrement situé dans la corbeille peut être supprimé définitivement ; veuillez d’abord le supprimer. |
RECORDING_PURGED | 409 | non | L’enregistrement a été supprimé définitivement (de la corbeille ou par un administrateur) et ne peut pas être restauré. |
CONFIRM_PURGE_REQUIRED | 400 | non | Pour réduire la fenêtre de la corbeille, il faut que la valeur « confirmPurge » soit définie sur « true ». |
TRANSCRIPTION_UNAVAILABLE | 400 | non | Les transcriptions ne sont pas disponibles pour ce compte. |
TRANSCRIPT_EXISTS | 409 | non | Une transcription de cet enregistrement existe déjà ou est en cours. |
NO_AUDIO | 409 | non | L’enregistrement ne contient pas de son à transcrire. |
TRANSCRIPT_NOT_READY | 409 | oui | La transcription n’est pas encore terminée ; seules les transcriptions terminées peuvent être exportées au format VTT, SRT ou TXT. |
TRANSCRIPT_RUNNING | 409 | non | La transcription est déjà en cours et ne peut pas être annulée. |
TRANSCRIPT_NOT_CANCELLABLE | 409 | non | Seule une transcription qui n’a pas encore commencé peut être annulée. |
WINDOW_TOO_LONG | 400 | non | La plage horaire demandée est trop longue. |
SUMMARY_TIMEOUT | 503 | oui | Le résumé a pris trop de temps ; veuillez réessayer. |
CAPTIONS_BUSY | 503 | oui | Le service de sous-titrage en direct a atteint sa capacité maximale ; veuillez réessayer plus tard. |
CAPTIONS_LANGUAGE_LIMIT | 409 | non | Il y a trop de langues de sous-titrage dans cette salle. |
CAPTIONS_NOT_PERMITTED | 403 | non | Il se peut que le participant n’utilise pas les sous-titres. |
INVALID_LANGUAGE | 400 | non | Le code de langue n’est pas pris en charge. |
Stockage des enregistrements
Section intitulée « Stockage des enregistrements »| Code | HTTP | Réessayable | Signification |
|---|---|---|---|
DESTINATION_LIMIT | 409 | non | L’organisation a atteint le nombre maximal de destinations de stockage. |
DESTINATION_ADMIN_DISABLED | 403 | non | CHAMPREP Le support a désactivé cette destination de stockage ; elle ne peut pas être réactivée par le client. |
ENDPOINT_NOT_ALLOWED | 400 | non | Le point de terminaison compatible S3 n’est pas autorisé (HTTPS sur le port 443 vers une adresse publique uniquement). |
REDELIVERY_LIMIT | 429 | oui | L’enregistrement a été envoyé à nouveau récemment, ou l’organisation en a envoyé un trop grand nombre au cours de cette heure ; veuillez réessayer plus tard. |
NO_ACTIVE_DESTINATION | 409 | non | Aucune destination de stockage active n’est associée à cet enregistrement. |
EGRESS_UNAVAILABLE | 503 | oui | Le service de facturation n’a pas pu être contacté pour prendre en charge ce téléchargement ; veuillez réessayer dans quelques instants. |
DELIVERY_NOT_CONFIGURED | 503 | non | Les destinations de rôle AWS ne sont pas encore disponibles ; utilisez des clés compatibles S3 (le code et le message vous ont été envoyés). |
CREDENTIALS_UNAVAILABLE | 503 | non | Le stockage des clés de destination n’est pas encore disponible ; utilisez un rôle AWS. |
Webhooks
Section intitulée « Webhooks »| Code | HTTP | Réessayable | Signification |
|---|---|---|---|
WEBHOOK_NOT_CONFIGURED | 409 | non | Aucun point de terminaison de webhook n’est configuré. |
WEBHOOK_URL_INVALID | 400 | non | L’URL du webhook n’est pas un point de terminaison HTTPS public sur le port 443 en dehors des domainesCHAMPREP. |
WEBHOOK_ENDPOINT_LIMIT | 409 | non | Le nombre de points de terminaison webhook prévu par le forfait est atteint (details.limit, details.used). |
WEBHOOK_ENDPOINT_NOT_FOUND | 404 | non | Le point de terminaison du webhook n’existe pas. |
WEBHOOK_ENDPOINT_DISABLED | 409 | non | Le point de terminaison du webhook est désactivé ; veuillez d’abord l’activer. |
WEBHOOK_ENDPOINT_ADMIN_DISABLED | 403 | non | CHAMPREP Le service d’assistance a désactivé le point de terminaison du webhook ; veuillez contacter le service d’assistance. |
WEBHOOK_URL_ADMIN_DISABLED | 403 | non | CHAMPREP Le service d’assistance a désactivé cette URL de webhook ; elle ne peut plus être ajoutée. Veuillez contacter le service d’assistance. |
WEBHOOK_EVENT_UNKNOWN | 400 | non | Un filtre d’événement ne correspond à aucun type d’événement connu (details.patterns). |
REPLAY_LIMIT | 409 | non | Cette transmission a été relancée trop souvent. |
REPLAY_QUOTA | 429 | oui | Trop de rediffusions ; veuillez patienter Retry-After secondes. |
DELIVERY_IN_PROGRESS | 409 | oui | L’envoi est en cours. |
Tableaux blancs
Section intitulée « Tableaux blancs »| Code | HTTP | Réessayable | Signification |
|---|---|---|---|
WHITEBOARD_UNAVAILABLE | 503 | oui | Le service de tableau blanc n’est pas disponible. |
WHITEBOARD_DISABLED | 403 | non | Les tableaux blancs sont désactivés pour ce compte. |
WHITEBOARD_ARCHIVED | 409 | non | Le tableau blanc est archivé. |
WHITEBOARD_LIMIT | 409 | non | La salle a atteint le nombre maximal de tableaux blancs. |
WHITEBOARD_QUOTA | 402 | non | Le quota de tableaux blancs est épuisé. |
WHITEBOARD_FILE_INVALID | 422 | non | Le fichier du tableau blanc n’a pas pu être lu. |
WHITEBOARD_FILE_LIMIT | 409 | non | Le tableau blanc a atteint le nombre maximal de fichiers. |
WHITEBOARD_FILE_PENDING | 409 | oui | Le téléchargement du fichier du tableau blanc n’est pas terminé. |
WHITEBOARD_FILE_SIZE | 400 | non | La taille de fichier déclarée n’est pas valide. |
WHITEBOARD_FILE_TOO_LARGE | 413 | non | Le fichier du tableau blanc est trop volumineux. |
WHITEBOARD_FILE_TYPE | 415 | non | Le type de fichier « tableau blanc » n’est pas autorisé. |
SNAPSHOT_TOO_LARGE | 413 | non | La capture d’écran du tableau blanc est trop volumineuse pour être renvoyée. |
Contrôle à distance
Section intitulée « Contrôle à distance »| Code | HTTP | Réessayable | Signification |
|---|---|---|---|
RC_BLOCKED | 403 | non | Le contrôle à distance est bloqué. |
RC_CLIPBOARD_OFF | 403 | non | Le partage du presse-papiers est désactivé. |
RC_CLIPBOARD_TOO_LARGE | 413 | non | Le contenu du presse-papiers est trop volumineux. |
RC_CONFLICT | 409 | non | Une autre demande de contrôle à distance est en conflit. |
RC_INVALID_REQUEST | 400 | non | La demande de contrôle à distance n’est pas valide. |
RC_NOT_PERMITTED | 403 | non | Le contrôle à distance n’est pas autorisé. |
RC_NO_BUDGET | 402 | non | Il ne reste plus de quota de contrôle à distance. |
RC_PENDING | 409 | non | Une demande de contrôle à distance est déjà en attente. |
RC_RATE_LIMITED | 429 | oui | Trop de demandes de contrôle à distance. |
RC_REAUTH_REQUIRED | 401 | non | Veuillez vous réauthentifier pour poursuivre le contrôle à distance. |
RC_SHARER_BUSY | 409 | non | L’utilisateur partageant est déjà contrôlé. |
RC_UNAVAILABLE | 404 | non | Le contrôle à distance n’est pas disponible. |
RC_WIDEN_REFUSED | 403 | non | L’autorisation de contrôle à distance ne peut pas être étendue. |
Télémétrie
Section intitulée « Télémétrie »| Code | HTTP | Réessayable | Signification |
|---|---|---|---|
INVALID_TELEMETRY | 400 | non | L’exemple de télémétrie n’est pas valide. |
TELEMETRY_RATE_LIMITED | 429 | oui | Trop d’échantillons de télémétrie. |