Errores de RTC
Cada error de RTC lleva asociado un código estable y legible por máquina código. Basarse en el código, nunca en el texto del mensaje: los mensajes pueden reformularse, pero los códigos nunca se renombran ni se reutilizan con otro significado.
Dos formatos de respuesta
Sección titulada «Dos formatos de respuesta»Por defecto. Sin un encabezado de versión, los errores conservan su formato original, por lo que las integraciones existentes no se ven afectadas:
{ "error": "Your plan allows 2 webhook endpoints", "code": "WEBHOOK_ENDPOINT_LIMIT" }code está presente en los errores que tienen un código específico. Los errores más antiguos pueden llevar únicamente ; el encabezado siempre indica el código. error; el X-Error-Code El encabezado siempre indica el código.
Sobre estructurado. Enviar RTC-Version: 2026-11-01 con una solicitud para recibir el sobre estructurado:
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" }}| Campo | Significado |
|---|---|
code | Código estable del catálogo |
message | Explicación legible para personas; no la analice sintácticamente |
details | Contexto estructurado opcional, por ejemplo limit y used, o issues (los campos no válidos) para INVALID_REQUEST |
requestId | El identificador de esta solicitud, que también se envía como X-Request-Id |
retryable | true al volver a intentar la misma solicitud más tarde puede tener éxito |
docUrl | Enlace a la entrada de este código más abajo |
La respuesta refleja la versión que se aplicó en el RTC-Version . Una fecha anterior a 2026-11-01 mantiene la estructura predeterminada. Véase versiones.
en cada respuesta
Sección titulada «en cada respuesta»| Encabezado | Cuándo | Significado |
|---|---|---|
X-Request-Id | Cada respuesta | Identificador único de la solicitud. Inclúyalo cuando se ponga en contacto con el servicio de asistencia. |
X-Error-Code | Cada error | El código estable, en ambos formatos de respuesta |
Retry-After | 429, y algunos 503 | Segundos de espera antes de volver a intentarlo |
X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset | Respuestas autenticadas | Véase Límites de frecuencia |
Gestión de errores
Sección titulada «Gestión de errores»retryable: false(4xxdistinto de429): corrija primero la solicitud, la credencial, el plan o el estado. Si se repite sin cambios, se obtiene la misma respuesta.retryable: true: vuelva a intentarlo con retroceso exponencial y fluctuación, respetandoRetry-After. Vuelva a intentar las operaciones de escritura únicamente cuando la operación sea idempotente o tras haber conciliado su resultado.401: falta la credencial, ha caducado o ha sido revocada.403: la credencial es válida, pero carece de ámbito, acceso al proyecto o derechos del plan.404también abarca recursos que pertenecen a otra persona. Nunca compruebe los identificadores de otros clientes.
Catálogo de códigos
Sección titulada «Catálogo de códigos»GET /v1/error-codes (sin autenticación) devuelve el catálogo actual como
{ "codes": [{ "code", "status", "retryable", "description" }] }. Se pueden añadir nuevos códigos en cualquier momento; trate un código desconocido como el código genérico de su estado HTTP.
Códigos genéricos (uno por estado HTTP, utilizados cuando no se aplica ningún código específico)
Sección titulada «Códigos genéricos (uno por estado HTTP, utilizados cuando no se aplica ningún código específico)»| Código | HTTP | Se puede volver a intentar | Significado |
|---|---|---|---|
INVALID_REQUEST | 400 | no | La solicitud presenta un formato incorrecto o un campo no es válido (details.issues enumera los campos). |
UNAUTHENTICATED | 401 | no | Credenciales ausentes, no válidas o caducadas. |
PAYMENT_REQUIRED | 402 | no | Es necesario realizar un pago antes de poder utilizar este servicio. |
FORBIDDEN | 403 | no | La credencial es válida, pero no está autorizada para realizar esta acción. |
NOT_FOUND | 404 | no | El recurso no existe o no es visible para estas credenciales. |
CONFLICT | 409 | no | La solicitud entra en conflicto con el estado actual. |
PAYLOAD_TOO_LARGE | 413 | no | El cuerpo de la solicitud es demasiado grande. |
UNSUPPORTED_MEDIA_TYPE | 415 | no | El tipo de contenido no es válido. |
RANGE_NOT_SATISFIABLE | 416 | no | El rango de bytes solicitado no es válido o no está disponible. |
UNPROCESSABLE | 422 | no | Se ha comprendido el contenido, pero no se puede procesar. |
RATE_LIMITED | 429 | Sí | Demasiadas solicitudes; espere a que Retry-After segundos. |
INTERNAL | 500 | Sí | Error inesperado del servidor; inténtelo de nuevo más tarde. |
SERVICE_UNAVAILABLE | 503 | Sí | Temporalmente no disponible; vuelva a intentarlo con un tiempo de espera. |
Suscripción y asignación
Sección titulada «Suscripción y asignación»Estas respuestas también incluyen offers (cómo solucionarlo: una prueba, una suscripción, una actualización, un paquete o añadir una tarjeta, cada uno de ellos con un enlace a CHAMPREP«Facturación») y, cuando se refiera a una asignación o función, feature.
| Código | HTTP | Se puede volver a intentar | Significado |
|---|---|---|---|
RTC_SUBSCRIPTION_REQUIRED | 402 | no | La cuenta no dispone de suscripción a RTC, periodo de prueba ni asignación incluida (véase offers). |
RTC_PAYMENT_REQUIRED | 402 | no | Una factura pendiente de pago bloquea el RTC; abónela en CHAMPREP Facturación. |
RTC_ACCESS_DENIED | 403 | no | Una política de la organización, del equipo o de la plataforma deniega el acceso a RTC (reasonCode (se indica cuál). |
RTC_ALLOWANCE_EXHAUSTED | 402 | no | Se ha agotado una asignación de RTC de la suscripción (feature indica cuáles; consulte offers). |
RTC_FEATURE_NOT_IN_PLAN | 403 | no | La suscripción no incluye esta función (véase offers). |
RTC_PLAN_LIMIT | 403 | no | Se ha alcanzado un límite de la suscripción (tamaño de la sala, salas abiertas al mismo tiempo). |
PAYMENT_METHOD_REQUIRED | 402 | no | La prueba requiere una tarjeta guardada en el espacio de trabajo de pago (véase offers). |
TRIAL_ALREADY_USED | 409 | no | Esta cuenta ya ha utilizado la prueba gratuita. |
TRIAL_NOT_ALLOWED | 403 | no | Esta cuenta no puede iniciar la prueba gratuita. |
TRIAL_UNAVAILABLE | 409 | no | La prueba gratuita no está disponible. |
ALREADY_SUBSCRIBED | 409 | no | La cuenta ya dispone de una suscripción a RTC. |
PRIMARY_TOKEN_REQUIRED | 401 | no | Para iniciar un periodo de prueba se requiere la sesión de la consola del titular de la cuenta. |
PRIMARY_TOKEN_INVALID | 401 | no | La sesión de la consola no es válida para iniciar una prueba; vuelva a iniciar sesión. |
PRIMARY_TOKEN_MISMATCH | 403 | no | Solo el titular de la cuenta puede iniciar este periodo de prueba. |
Paginación e idempotencia
Sección titulada «Paginación e idempotencia»| Código | HTTP | Se puede volver a intentar | Significado |
|---|---|---|---|
INVALID_CURSOR | 400 | no | El cursor tiene un formato incorrecto o pertenece a otra lista. |
IDEMPOTENCY_KEY_INVALID | 400 | no | El Idempotency-Key El encabezado tiene un formato incorrecto. |
IDEMPOTENCY_KEY_REUSED | 409 | no | El Idempotency-Key Se ha utilizado con otra solicitud. |
IDEMPOTENCY_IN_PROGRESS | 409 | Sí | La primera solicitud con este Idempotency-Key sigue en ejecución. |
Salas, tokens de participante y contenido multimedia
Sección titulada «Salas, tokens de participante y contenido multimedia»| Código | HTTP | Se puede volver a intentar | Significado |
|---|---|---|---|
ROOM_EXTERNAL_REF_CONFLICT | 409 | no | Una sala abierta del proyecto ya utiliza esto externalRef. |
ROOM_FULL | 409 | no | La sala ha alcanzado su límite de participantes. |
ROOM_LOCKED | 409 | no | La sala está bloqueada; solo los anfitriones pueden unirse. |
ROOM_ALLOWANCE_UNAVAILABLE | 503 | Sí | No se ha podido leer el límite de participantes de la sala. |
PARTICIPANT_BANNED | 409 | no | Esta identidad tiene prohibido el acceso a la sala. |
PARTICIPANT_REMOVED | 403 | no | Este participante ha sido expulsado de la sala. |
MEDIA_CAPACITY | 503 | Sí | Ningún nodo multimedia dispone de espacio para esto en este momento; inténtelo de nuevo más tarde. |
MEDIA_NODE_UNAVAILABLE | 503 | Sí | El nodo multimedia de la sala no está disponible; inténtelo de nuevo. |
MEDIA_UNAVAILABLE | 503 | Sí | El servicio multimedia no está disponible; inténtelo de nuevo. |
HOST_MUTED | 403 | no | Un anfitrión ha silenciado esta fuente. |
DATA_NOT_PERMITTED | 403 | no | Es posible que el participante no pueda enviar mensajes de la aplicación. |
MESSAGE_TOO_LARGE | 400 | no | El mensaje de la aplicación es demasiado grande. |
MESSAGE_RATE_LIMITED | 429 | Sí | Demasiados mensajes de la aplicación de este participante. |
ROOM_MESSAGE_RATE_LIMITED | 429 | Sí | Hay demasiados mensajes de la aplicación en esta sala. |
RESERVED_TOPIC | 400 | no | El tema del mensaje de la aplicación está reservado. |
INVALID_RECIPIENTS | 400 | no | Los destinatarios del mensaje de la aplicación no son válidos. |
RESUME_REFUSED | 403 | no | No es posible reanudar la sesión. |
RESUME_UNAVAILABLE | 503 | Sí | La función de reanudación no está disponible temporalmente. |
FIRST_PARTY | 409 | no | Reservado para los productos propios CHAMPREPde . |
FIRST_PARTY_NOT_READY | 503 | Sí | El inquilino de primera parte aún no se ha aprovisionado. |
Tokens de acceso y claves de firma de proyectos
Sección titulada «Tokens de acceso y claves de firma de proyectos»| Código | HTTP | Se puede volver a intentar | Significado |
|---|---|---|---|
JOIN_GRANT_INVALID | 401 | no | El token de acceso tiene un formato incorrecto, ha caducado, está mal firmado o su clave de firma ha sido revocada. |
JOIN_GRANT_USED | 409 | no | Este token de acceso ya se ha utilizado (son de un solo uso). |
SIGNING_KEY_LIMIT | 409 | no | El proyecto ya cuenta con el número máximo de claves de firma activas. |
SIGNING_KEY_INVALID | 400 | no | La clave pública no es un JWK P-256 válido. |
Grabaciones, transcripciones y subtítulos
Sección titulada «Grabaciones, transcripciones y subtítulos»| Código | HTTP | Se puede volver a intentar | Significado |
|---|---|---|---|
COMPOSITE_UNAVAILABLE | 400 | no | La grabación compuesta no está disponible. |
DELETE_NOT_AVAILABLE | 403 | no | Los clientes no pueden eliminar las grabaciones (ya no se envían: DELETE /v1/recordings/:id envía la grabación a la Papelera, donde se elimina automáticamente al cabo de 30 días). |
RECORDING_ACTIVE | 409 | no | La grabación sigue en curso. |
RECORDING_SETTLING | 409 | Sí | La grabación aún se está almacenando. |
RECORDING_NOT_READY | 409 | no | La grabación aún no ha finalizado (las entregas requieren una grabación lista). |
RECORDING_NOT_IN_TRASH | 409 | no | Solo se puede eliminar definitivamente una grabación que se encuentre en la Papelera; elimínela primero. |
RECORDING_PURGED | 409 | no | La grabación se ha eliminado de forma definitiva (de la Papelera o por un administrador) y no se puede recuperar. |
CONFIRM_PURGE_REQUIRED | 400 | no | Para reducir el tamaño de la ventana de la Papelera se requiere que confirmPurge: true. |
TRANSCRIPTION_UNAVAILABLE | 400 | no | No hay transcripciones disponibles para esta cuenta. |
TRANSCRIPT_EXISTS | 409 | no | Ya existe una transcripción de esta grabación o se está procesando. |
NO_AUDIO | 409 | no | La grabación no contiene audio que transcribir. |
TRANSCRIPT_NOT_READY | 409 | Sí | La transcripción aún no está terminada; solo una transcripción finalizada se puede exportar como VTT, SRT o TXT. |
TRANSCRIPT_RUNNING | 409 | no | La transcripción ya se está generando y no se puede cancelar. |
TRANSCRIPT_NOT_CANCELLABLE | 409 | no | Solo se puede cancelar una transcripción que aún no haya comenzado. |
WINDOW_TOO_LONG | 400 | no | El intervalo de tiempo solicitado es demasiado largo. |
SUMMARY_TIMEOUT | 503 | Sí | El resumen ha tardado demasiado; inténtelo de nuevo. |
CAPTIONS_BUSY | 503 | Sí | Los subtítulos en directo han alcanzado su capacidad máxima; inténtelo de nuevo más tarde. |
CAPTIONS_LANGUAGE_LIMIT | 409 | no | Hay demasiados idiomas de subtítulos en esta sala. |
CAPTIONS_NOT_PERMITTED | 403 | no | Es posible que el participante no utilice subtítulos. |
INVALID_LANGUAGE | 400 | no | El código de idioma no es compatible. |
Almacenamiento de grabaciones
Sección titulada «Almacenamiento de grabaciones»| Código | HTTP | Se puede volver a intentar | Significado |
|---|---|---|---|
DESTINATION_LIMIT | 409 | no | La organización ha alcanzado el número máximo de destinos de almacenamiento. |
DESTINATION_ADMIN_DISABLED | 403 | no | CHAMPREP El servicio de asistencia ha desactivado este destino de almacenamiento; el cliente no puede volver a activarlo. |
ENDPOINT_NOT_ALLOWED | 400 | no | El punto final compatible con S3 no está permitido (solo HTTPS en el puerto 443 a una dirección pública). |
REDELIVERY_LIMIT | 429 | Sí | La grabación se ha enviado de nuevo recientemente, o bien la organización ha enviado demasiadas en esta hora; inténtelo de nuevo más tarde. |
NO_ACTIVE_DESTINATION | 409 | no | No hay ningún destino de almacenamiento activo asociado a esta grabación. |
EGRESS_UNAVAILABLE | 503 | Sí | No se ha podido contactar con el servicio de facturación para cubrir esta descarga; inténtelo de nuevo en breve. |
DELIVERY_NOT_CONFIGURED | 503 | no | Los destinos de roles de AWS aún no están disponibles; utilice claves compatibles con S3 (se han enviado el código y el mensaje). |
CREDENTIALS_UNAVAILABLE | 503 | no | El almacenamiento de claves de destino aún no está disponible; utilice un rol de AWS. |
Webhooks
Sección titulada «Webhooks»| Código | HTTP | Se puede volver a intentar | Significado |
|---|---|---|---|
WEBHOOK_NOT_CONFIGURED | 409 | no | No hay ningún punto final de webhook configurado. |
WEBHOOK_URL_INVALID | 400 | no | La URL del webhook no es un punto final HTTPS público en el puerto 443 fuera de los dominiosCHAMPREP. |
WEBHOOK_ENDPOINT_LIMIT | 409 | no | Se ha alcanzado el número de puntos finales de webhook del plan (details.limit, details.used). |
WEBHOOK_ENDPOINT_NOT_FOUND | 404 | no | El punto final del webhook no existe. |
WEBHOOK_ENDPOINT_DISABLED | 409 | no | El punto final del webhook está desactivado; actívelo primero. |
WEBHOOK_ENDPOINT_ADMIN_DISABLED | 403 | no | CHAMPREP El servicio de asistencia ha desactivado el punto final del webhook; póngase en contacto con el servicio de asistencia. |
WEBHOOK_URL_ADMIN_DISABLED | 403 | no | CHAMPREP El servicio de asistencia ha desactivado esta URL de webhook; no se puede volver a añadir. Póngase en contacto con el servicio de asistencia. |
WEBHOOK_EVENT_UNKNOWN | 400 | no | Un filtro de eventos no coincide con ningún tipo de evento conocido (details.patterns). |
REPLAY_LIMIT | 409 | no | Esta entrega se ha repetido demasiadas veces. |
REPLAY_QUOTA | 429 | Sí | Demasiadas repeticiones; espere a que Retry-After segundos. |
DELIVERY_IN_PROGRESS | 409 | Sí | El envío se está realizando en este momento. |
Pizarras
Sección titulada «Pizarras»| Código | HTTP | Se puede volver a intentar | Significado |
|---|---|---|---|
WHITEBOARD_UNAVAILABLE | 503 | Sí | El servicio de pizarra no está disponible. |
WHITEBOARD_DISABLED | 403 | no | Las pizarras están desactivadas para esta cuenta. |
WHITEBOARD_ARCHIVED | 409 | no | La pizarra está archivada. |
WHITEBOARD_LIMIT | 409 | no | La sala ha alcanzado el número máximo de pizarras. |
WHITEBOARD_QUOTA | 402 | no | Se ha agotado el cupo de pizarras blancas. |
WHITEBOARD_FILE_INVALID | 422 | no | No se ha podido leer el archivo de la pizarra. |
WHITEBOARD_FILE_LIMIT | 409 | no | La pizarra ha alcanzado el número máximo de archivos. |
WHITEBOARD_FILE_PENDING | 409 | Sí | La carga del archivo de la pizarra no ha finalizado. |
WHITEBOARD_FILE_SIZE | 400 | no | El tamaño de archivo declarado no es válido. |
WHITEBOARD_FILE_TOO_LARGE | 413 | no | El archivo de la pizarra es demasiado grande. |
WHITEBOARD_FILE_TYPE | 415 | no | No se permite el tipo de archivo de pizarra. |
SNAPSHOT_TOO_LARGE | 413 | no | La captura de pantalla de la pizarra es demasiado grande para enviarla. |
Control remoto
Sección titulada «Control remoto»| Código | HTTP | Se puede volver a intentar | Significado |
|---|---|---|---|
RC_BLOCKED | 403 | no | El control remoto está bloqueado. |
RC_CLIPBOARD_OFF | 403 | no | El uso compartido del portapapeles está desactivado. |
RC_CLIPBOARD_TOO_LARGE | 413 | no | El contenido del portapapeles es demasiado grande. |
RC_CONFLICT | 409 | no | Existe un conflicto con otra solicitud de control remoto. |
RC_INVALID_REQUEST | 400 | no | La solicitud de control remoto no es válida. |
RC_NOT_PERMITTED | 403 | no | No se permite el control remoto. |
RC_NO_BUDGET | 402 | no | No quedan derechos de control remoto disponibles. |
RC_PENDING | 409 | no | Ya hay una solicitud de control remoto pendiente. |
RC_RATE_LIMITED | 429 | Sí | Demasiadas solicitudes de control remoto. |
RC_REAUTH_REQUIRED | 401 | no | Vuelva a autenticarse para continuar con el control remoto. |
RC_SHARER_BUSY | 409 | no | El usuario que comparte ya está bajo control. |
RC_UNAVAILABLE | 404 | no | El control remoto no está disponible. |
RC_WIDEN_REFUSED | 403 | no | No es posible ampliar el permiso de control remoto. |
Telemetría
Sección titulada «Telemetría»| Código | HTTP | Se puede volver a intentar | Significado |
|---|---|---|---|
INVALID_TELEMETRY | 400 | no | La muestra de telemetría no es válida. |
TELEMETRY_RATE_LIMITED | 429 | Sí | Demasiadas muestras de telemetría. |