Aller au contenu
Documentation

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.

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 :

Fenêtre de terminal
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"
}
}
ChampSignification
codeCode stable issu du catalogue
messageExplication lisible par l’utilisateur ; ne l’analysez pas
detailsContexte structuré facultatif, par exemple limit et used, ou issues (les champs non valides) pour INVALID_REQUEST
requestIdL’identifiant de cette requête, également envoyé sous la forme X-Request-Id
retryabletrue : une nouvelle tentative ultérieure de la même requête peut aboutir
docUrlLien 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êteQuandSignification
X-Request-IdChaque réponseIdentifiant unique de la requête. Veuillez l’indiquer lorsque vous contactez le service d’assistance.
X-Error-CodeChaque erreurLe code stable, dans les deux formats de réponse
Retry-After429, et certains 503Nombre de secondes à attendre avant de réessayer
X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-ResetRéponses authentifiéesVoir limites de débit

  • retryable: false (4xx autre que 429) : 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 respectant Retry-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.
  • 404 couvre également les ressources appartenant à un tiers. Ne jamais interroger les identifiants d’autres clients.

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) »
CodeHTTPRéessayableSignification
INVALID_REQUEST400nonLa requête est mal formée ou un champ n’est pas valide (details.issues répertorie les champs).
UNAUTHENTICATED401nonIdentifiants manquants, non valides ou périmés.
PAYMENT_REQUIRED402nonUn paiement est dû avant que cette fonctionnalité puisse être utilisée.
FORBIDDEN403nonLes identifiants sont valides, mais l’accès à cette fonctionnalité n’est pas autorisé.
NOT_FOUND404nonLa ressource n’existe pas ou n’est pas visible pour cet identifiant.
CONFLICT409nonLa demande est en conflit avec l’état actuel.
PAYLOAD_TOO_LARGE413nonLe corps de la requête est trop volumineux.
UNSUPPORTED_MEDIA_TYPE415nonLe type de contenu n’est pas accepté.
RANGE_NOT_SATISFIABLE416nonLa plage d’octets demandée n’est pas valide ou n’est pas disponible.
UNPROCESSABLE422nonLe contenu a été compris mais ne peut pas être traité.
RATE_LIMITED429ouiTrop de demandes ; veuillez patienter jusqu’à Retry-After secondes.
INTERNAL500ouiErreur serveur inattendue ; veuillez réessayer plus tard.
SERVICE_UNAVAILABLE503ouiTemporairement indisponible ; réessayez en respectant un délai d’attente.

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.

CodeHTTPRéessayableSignification
RTC_SUBSCRIPTION_REQUIRED402nonLe compte ne dispose d’aucun abonnement RTC, d’aucune période d’essai ni d’aucun quota inclus (voir offers).
RTC_PAYMENT_REQUIRED402nonUne facture impayée bloque l’accès au RTC ; réglez-la dans la section « FacturationCHAMPREP ».
RTC_ACCESS_DENIED403nonUne politique de l’organisation, de l’équipe ou de la plateforme interdit l’accès au RTC (reasonCode (précise lesquels).
RTC_ALLOWANCE_EXHAUSTED402nonUne partie du quota RTC de l’abonnement a été utilisée (feature précise lesquels ; voir offers).
RTC_FEATURE_NOT_IN_PLAN403nonL’abonnement ne comprend pas cette fonctionnalité (voir offers).
RTC_PLAN_LIMIT403nonUne limite de l’abonnement a été atteinte (taille de la salle, nombre de salles ouvertes simultanément).
PAYMENT_METHOD_REQUIRED402nonL’essai nécessite une carte enregistrée dans l’espace de travail payant (voir offers).
TRIAL_ALREADY_USED409nonL’essai gratuit a déjà été utilisé par ce compte.
TRIAL_NOT_ALLOWED403nonCe compte ne peut pas démarrer l’essai gratuit.
TRIAL_UNAVAILABLE409nonL’essai gratuit n’est pas disponible.
ALREADY_SUBSCRIBED409nonLe compte dispose déjà d’un abonnement RTC.
PRIMARY_TOKEN_REQUIRED401nonLe lancement d’un procès nécessite la session de la console du titulaire du compte.
PRIMARY_TOKEN_INVALID401nonLa session de la console n’est pas valide pour démarrer un essai ; veuillez vous reconnecter.
PRIMARY_TOKEN_MISMATCH403nonSeul le titulaire du compte peut démarrer cette période d’essai.

CodeHTTPRéessayableSignification
INVALID_CURSOR400nonLe cursor est mal formé ou appartient à une autre liste.
IDEMPOTENCY_KEY_INVALID400nonLe Idempotency-Key L’en-tête est mal formé.
IDEMPOTENCY_KEY_REUSED409nonLe Idempotency-Key a été utilisé avec une autre requête.
IDEMPOTENCY_IN_PROGRESS409ouiLa première requête avec ce Idempotency-Key est toujours en cours d’exécution.

CodeHTTPRéessayableSignification
ROOM_EXTERNAL_REF_CONFLICT409nonUne salle ouverte du projet utilise déjà cette externalRef.
ROOM_FULL409nonLa salle a atteint sa limite de participants.
ROOM_LOCKED409nonLa salle est verrouillée ; seuls les hôtes peuvent y accéder.
ROOM_ALLOWANCE_UNAVAILABLE503ouiLe nombre maximal de participants autorisés dans la salle n’a pas pu être lu.
PARTICIPANT_BANNED409nonCette identité est bannie de la salle.
PARTICIPANT_REMOVED403nonCe participant a été exclu de la salle.
MEDIA_CAPACITY503ouiAucun nœud multimédia ne dispose actuellement de place pour cela ; veuillez réessayer plus tard.
MEDIA_NODE_UNAVAILABLE503ouiLe nœud multimédia de la salle n’est pas disponible ; veuillez réessayer.
MEDIA_UNAVAILABLE503ouiLe service multimédia n’est pas disponible ; veuillez réessayer.
HOST_MUTED403nonUn animateur a désactivé le son de cette source.
DATA_NOT_PERMITTED403nonLe participant n’est pas autorisé à envoyer de messages d’application.
MESSAGE_TOO_LARGE400nonLe message d’application est trop volumineux.
MESSAGE_RATE_LIMITED429ouiCe participant a envoyé un trop grand nombre de messages d’application.
ROOM_MESSAGE_RATE_LIMITED429ouiIl y a trop de messages d’application dans cette salle.
RESERVED_TOPIC400nonLe sujet du message d’application est réservé.
INVALID_RECIPIENTS400nonLes destinataires du message d’application ne sont pas valides.
RESUME_REFUSED403nonLa session ne peut pas être reprise.
RESUME_UNAVAILABLE503ouiLa fonction de reprise est temporairement indisponible.
FIRST_PARTY409nonRéservé aux produits CHAMPREPde .
FIRST_PARTY_NOT_READY503ouiLe 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 »
CodeHTTPRéessayableSignification
JOIN_GRANT_INVALID401nonLe jeton de connexion est mal formé, a expiré, est mal signé ou sa clé de signature a été révoquée.
JOIN_GRANT_USED409nonCe jeton de connexion a déjà été utilisé (ils ne sont valables qu’une seule fois).
SIGNING_KEY_LIMIT409nonLe projet a déjà atteint le nombre maximal de clés de signature actives.
SIGNING_KEY_INVALID400nonLa clé publique n’est pas un JWK P-256 valide.

CodeHTTPRéessayableSignification
COMPOSITE_UNAVAILABLE400nonL’enregistrement composite n’est pas disponible.
DELETE_NOT_AVAILABLE403nonLes 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_ACTIVE409nonL’enregistrement est toujours en cours.
RECORDING_SETTLING409ouiL’enregistrement est toujours en cours de stockage.
RECORDING_NOT_READY409nonL’enregistrement n’est pas encore terminé (les livraisons nécessitent un enregistrement prêt).
RECORDING_NOT_IN_TRASH409nonSeul un enregistrement situé dans la corbeille peut être supprimé définitivement ; veuillez d’abord le supprimer.
RECORDING_PURGED409nonL’enregistrement a été supprimé définitivement (de la corbeille ou par un administrateur) et ne peut pas être restauré.
CONFIRM_PURGE_REQUIRED400nonPour réduire la fenêtre de la corbeille, il faut que la valeur « confirmPurge » soit définie sur « true ».
TRANSCRIPTION_UNAVAILABLE400nonLes transcriptions ne sont pas disponibles pour ce compte.
TRANSCRIPT_EXISTS409nonUne transcription de cet enregistrement existe déjà ou est en cours.
NO_AUDIO409nonL’enregistrement ne contient pas de son à transcrire.
TRANSCRIPT_NOT_READY409ouiLa transcription n’est pas encore terminée ; seules les transcriptions terminées peuvent être exportées au format VTT, SRT ou TXT.
TRANSCRIPT_RUNNING409nonLa transcription est déjà en cours et ne peut pas être annulée.
TRANSCRIPT_NOT_CANCELLABLE409nonSeule une transcription qui n’a pas encore commencé peut être annulée.
WINDOW_TOO_LONG400nonLa plage horaire demandée est trop longue.
SUMMARY_TIMEOUT503ouiLe résumé a pris trop de temps ; veuillez réessayer.
CAPTIONS_BUSY503ouiLe service de sous-titrage en direct a atteint sa capacité maximale ; veuillez réessayer plus tard.
CAPTIONS_LANGUAGE_LIMIT409nonIl y a trop de langues de sous-titrage dans cette salle.
CAPTIONS_NOT_PERMITTED403nonIl se peut que le participant n’utilise pas les sous-titres.
INVALID_LANGUAGE400nonLe code de langue n’est pas pris en charge.

CodeHTTPRéessayableSignification
DESTINATION_LIMIT409nonL’organisation a atteint le nombre maximal de destinations de stockage.
DESTINATION_ADMIN_DISABLED403nonCHAMPREP Le support a désactivé cette destination de stockage ; elle ne peut pas être réactivée par le client.
ENDPOINT_NOT_ALLOWED400nonLe point de terminaison compatible S3 n’est pas autorisé (HTTPS sur le port 443 vers une adresse publique uniquement).
REDELIVERY_LIMIT429ouiL’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_DESTINATION409nonAucune destination de stockage active n’est associée à cet enregistrement.
EGRESS_UNAVAILABLE503ouiLe 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_CONFIGURED503nonLes 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_UNAVAILABLE503nonLe stockage des clés de destination n’est pas encore disponible ; utilisez un rôle AWS.
CodeHTTPRéessayableSignification
WEBHOOK_NOT_CONFIGURED409nonAucun point de terminaison de webhook n’est configuré.
WEBHOOK_URL_INVALID400nonL’URL du webhook n’est pas un point de terminaison HTTPS public sur le port 443 en dehors des domainesCHAMPREP.
WEBHOOK_ENDPOINT_LIMIT409nonLe nombre de points de terminaison webhook prévu par le forfait est atteint (details.limit, details.used).
WEBHOOK_ENDPOINT_NOT_FOUND404nonLe point de terminaison du webhook n’existe pas.
WEBHOOK_ENDPOINT_DISABLED409nonLe point de terminaison du webhook est désactivé ; veuillez d’abord l’activer.
WEBHOOK_ENDPOINT_ADMIN_DISABLED403nonCHAMPREP Le service d’assistance a désactivé le point de terminaison du webhook ; veuillez contacter le service d’assistance.
WEBHOOK_URL_ADMIN_DISABLED403nonCHAMPREP 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_UNKNOWN400nonUn filtre d’événement ne correspond à aucun type d’événement connu (details.patterns).
REPLAY_LIMIT409nonCette transmission a été relancée trop souvent.
REPLAY_QUOTA429ouiTrop de rediffusions ; veuillez patienter Retry-After secondes.
DELIVERY_IN_PROGRESS409ouiL’envoi est en cours.

CodeHTTPRéessayableSignification
WHITEBOARD_UNAVAILABLE503ouiLe service de tableau blanc n’est pas disponible.
WHITEBOARD_DISABLED403nonLes tableaux blancs sont désactivés pour ce compte.
WHITEBOARD_ARCHIVED409nonLe tableau blanc est archivé.
WHITEBOARD_LIMIT409nonLa salle a atteint le nombre maximal de tableaux blancs.
WHITEBOARD_QUOTA402nonLe quota de tableaux blancs est épuisé.
WHITEBOARD_FILE_INVALID422nonLe fichier du tableau blanc n’a pas pu être lu.
WHITEBOARD_FILE_LIMIT409nonLe tableau blanc a atteint le nombre maximal de fichiers.
WHITEBOARD_FILE_PENDING409ouiLe téléchargement du fichier du tableau blanc n’est pas terminé.
WHITEBOARD_FILE_SIZE400nonLa taille de fichier déclarée n’est pas valide.
WHITEBOARD_FILE_TOO_LARGE413nonLe fichier du tableau blanc est trop volumineux.
WHITEBOARD_FILE_TYPE415nonLe type de fichier « tableau blanc » n’est pas autorisé.
SNAPSHOT_TOO_LARGE413nonLa capture d’écran du tableau blanc est trop volumineuse pour être renvoyée.

CodeHTTPRéessayableSignification
RC_BLOCKED403nonLe contrôle à distance est bloqué.
RC_CLIPBOARD_OFF403nonLe partage du presse-papiers est désactivé.
RC_CLIPBOARD_TOO_LARGE413nonLe contenu du presse-papiers est trop volumineux.
RC_CONFLICT409nonUne autre demande de contrôle à distance est en conflit.
RC_INVALID_REQUEST400nonLa demande de contrôle à distance n’est pas valide.
RC_NOT_PERMITTED403nonLe contrôle à distance n’est pas autorisé.
RC_NO_BUDGET402nonIl ne reste plus de quota de contrôle à distance.
RC_PENDING409nonUne demande de contrôle à distance est déjà en attente.
RC_RATE_LIMITED429ouiTrop de demandes de contrôle à distance.
RC_REAUTH_REQUIRED401nonVeuillez vous réauthentifier pour poursuivre le contrôle à distance.
RC_SHARER_BUSY409nonL’utilisateur partageant est déjà contrôlé.
RC_UNAVAILABLE404nonLe contrôle à distance n’est pas disponible.
RC_WIDEN_REFUSED403nonL’autorisation de contrôle à distance ne peut pas être étendue.

CodeHTTPRéessayableSignification
INVALID_TELEMETRY400nonL’exemple de télémétrie n’est pas valide.
TELEMETRY_RATE_LIMITED429ouiTrop d’échantillons de télémétrie.