Ir al contenido
Documentation

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.

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:

Ventana 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"
}
}
CampoSignificado
codeCódigo estable del catálogo
messageExplicación legible para personas; no la analice sintácticamente
detailsContexto estructurado opcional, por ejemplo limit y used, o issues (los campos no válidos) para INVALID_REQUEST
requestIdEl identificador de esta solicitud, que también se envía como X-Request-Id
retryabletrue al volver a intentar la misma solicitud más tarde puede tener éxito
docUrlEnlace 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.

EncabezadoCuándoSignificado
X-Request-IdCada respuestaIdentificador único de la solicitud. Inclúyalo cuando se ponga en contacto con el servicio de asistencia.
X-Error-CodeCada errorEl código estable, en ambos formatos de respuesta
Retry-After429, y algunos 503Segundos de espera antes de volver a intentarlo
X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-ResetRespuestas autenticadasVéase Límites de frecuencia

  • retryable: false (4xx distinto de 429): 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, respetando Retry-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.
  • 404 también abarca recursos que pertenecen a otra persona. Nunca compruebe los identificadores de otros clientes.

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ódigoHTTPSe puede volver a intentarSignificado
INVALID_REQUEST400noLa solicitud presenta un formato incorrecto o un campo no es válido (details.issues enumera los campos).
UNAUTHENTICATED401noCredenciales ausentes, no válidas o caducadas.
PAYMENT_REQUIRED402noEs necesario realizar un pago antes de poder utilizar este servicio.
FORBIDDEN403noLa credencial es válida, pero no está autorizada para realizar esta acción.
NOT_FOUND404noEl recurso no existe o no es visible para estas credenciales.
CONFLICT409noLa solicitud entra en conflicto con el estado actual.
PAYLOAD_TOO_LARGE413noEl cuerpo de la solicitud es demasiado grande.
UNSUPPORTED_MEDIA_TYPE415noEl tipo de contenido no es válido.
RANGE_NOT_SATISFIABLE416noEl rango de bytes solicitado no es válido o no está disponible.
UNPROCESSABLE422noSe ha comprendido el contenido, pero no se puede procesar.
RATE_LIMITED429SíDemasiadas solicitudes; espere a que Retry-After segundos.
INTERNAL500SíError inesperado del servidor; inténtelo de nuevo más tarde.
SERVICE_UNAVAILABLE503SíTemporalmente no disponible; vuelva a intentarlo con un tiempo de espera.

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ódigoHTTPSe puede volver a intentarSignificado
RTC_SUBSCRIPTION_REQUIRED402noLa cuenta no dispone de suscripción a RTC, periodo de prueba ni asignación incluida (véase offers).
RTC_PAYMENT_REQUIRED402noUna factura pendiente de pago bloquea el RTC; abónela en CHAMPREP Facturación.
RTC_ACCESS_DENIED403noUna política de la organización, del equipo o de la plataforma deniega el acceso a RTC (reasonCode (se indica cuál).
RTC_ALLOWANCE_EXHAUSTED402noSe ha agotado una asignación de RTC de la suscripción (feature indica cuáles; consulte offers).
RTC_FEATURE_NOT_IN_PLAN403noLa suscripción no incluye esta función (véase offers).
RTC_PLAN_LIMIT403noSe ha alcanzado un límite de la suscripción (tamaño de la sala, salas abiertas al mismo tiempo).
PAYMENT_METHOD_REQUIRED402noLa prueba requiere una tarjeta guardada en el espacio de trabajo de pago (véase offers).
TRIAL_ALREADY_USED409noEsta cuenta ya ha utilizado la prueba gratuita.
TRIAL_NOT_ALLOWED403noEsta cuenta no puede iniciar la prueba gratuita.
TRIAL_UNAVAILABLE409noLa prueba gratuita no está disponible.
ALREADY_SUBSCRIBED409noLa cuenta ya dispone de una suscripción a RTC.
PRIMARY_TOKEN_REQUIRED401noPara iniciar un periodo de prueba se requiere la sesión de la consola del titular de la cuenta.
PRIMARY_TOKEN_INVALID401noLa sesión de la consola no es válida para iniciar una prueba; vuelva a iniciar sesión.
PRIMARY_TOKEN_MISMATCH403noSolo el titular de la cuenta puede iniciar este periodo de prueba.

CódigoHTTPSe puede volver a intentarSignificado
INVALID_CURSOR400noEl cursor tiene un formato incorrecto o pertenece a otra lista.
IDEMPOTENCY_KEY_INVALID400noEl Idempotency-Key El encabezado tiene un formato incorrecto.
IDEMPOTENCY_KEY_REUSED409noEl Idempotency-Key Se ha utilizado con otra solicitud.
IDEMPOTENCY_IN_PROGRESS409Sí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ódigoHTTPSe puede volver a intentarSignificado
ROOM_EXTERNAL_REF_CONFLICT409noUna sala abierta del proyecto ya utiliza esto externalRef.
ROOM_FULL409noLa sala ha alcanzado su límite de participantes.
ROOM_LOCKED409noLa sala está bloqueada; solo los anfitriones pueden unirse.
ROOM_ALLOWANCE_UNAVAILABLE503SíNo se ha podido leer el límite de participantes de la sala.
PARTICIPANT_BANNED409noEsta identidad tiene prohibido el acceso a la sala.
PARTICIPANT_REMOVED403noEste participante ha sido expulsado de la sala.
MEDIA_CAPACITY503SíNingún nodo multimedia dispone de espacio para esto en este momento; inténtelo de nuevo más tarde.
MEDIA_NODE_UNAVAILABLE503SíEl nodo multimedia de la sala no está disponible; inténtelo de nuevo.
MEDIA_UNAVAILABLE503SíEl servicio multimedia no está disponible; inténtelo de nuevo.
HOST_MUTED403noUn anfitrión ha silenciado esta fuente.
DATA_NOT_PERMITTED403noEs posible que el participante no pueda enviar mensajes de la aplicación.
MESSAGE_TOO_LARGE400noEl mensaje de la aplicación es demasiado grande.
MESSAGE_RATE_LIMITED429SíDemasiados mensajes de la aplicación de este participante.
ROOM_MESSAGE_RATE_LIMITED429SíHay demasiados mensajes de la aplicación en esta sala.
RESERVED_TOPIC400noEl tema del mensaje de la aplicación está reservado.
INVALID_RECIPIENTS400noLos destinatarios del mensaje de la aplicación no son válidos.
RESUME_REFUSED403noNo es posible reanudar la sesión.
RESUME_UNAVAILABLE503SíLa función de reanudación no está disponible temporalmente.
FIRST_PARTY409noReservado para los productos propios CHAMPREPde .
FIRST_PARTY_NOT_READY503Sí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ódigoHTTPSe puede volver a intentarSignificado
JOIN_GRANT_INVALID401noEl token de acceso tiene un formato incorrecto, ha caducado, está mal firmado o su clave de firma ha sido revocada.
JOIN_GRANT_USED409noEste token de acceso ya se ha utilizado (son de un solo uso).
SIGNING_KEY_LIMIT409noEl proyecto ya cuenta con el número máximo de claves de firma activas.
SIGNING_KEY_INVALID400noLa clave pública no es un JWK P-256 válido.

CódigoHTTPSe puede volver a intentarSignificado
COMPOSITE_UNAVAILABLE400noLa grabación compuesta no está disponible.
DELETE_NOT_AVAILABLE403noLos 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_ACTIVE409noLa grabación sigue en curso.
RECORDING_SETTLING409SíLa grabación aún se está almacenando.
RECORDING_NOT_READY409noLa grabación aún no ha finalizado (las entregas requieren una grabación lista).
RECORDING_NOT_IN_TRASH409noSolo se puede eliminar definitivamente una grabación que se encuentre en la Papelera; elimínela primero.
RECORDING_PURGED409noLa grabación se ha eliminado de forma definitiva (de la Papelera o por un administrador) y no se puede recuperar.
CONFIRM_PURGE_REQUIRED400noPara reducir el tamaño de la ventana de la Papelera se requiere que confirmPurge: true.
TRANSCRIPTION_UNAVAILABLE400noNo hay transcripciones disponibles para esta cuenta.
TRANSCRIPT_EXISTS409noYa existe una transcripción de esta grabación o se está procesando.
NO_AUDIO409noLa grabación no contiene audio que transcribir.
TRANSCRIPT_NOT_READY409SíLa transcripción aún no está terminada; solo una transcripción finalizada se puede exportar como VTT, SRT o TXT.
TRANSCRIPT_RUNNING409noLa transcripción ya se está generando y no se puede cancelar.
TRANSCRIPT_NOT_CANCELLABLE409noSolo se puede cancelar una transcripción que aún no haya comenzado.
WINDOW_TOO_LONG400noEl intervalo de tiempo solicitado es demasiado largo.
SUMMARY_TIMEOUT503SíEl resumen ha tardado demasiado; inténtelo de nuevo.
CAPTIONS_BUSY503SíLos subtítulos en directo han alcanzado su capacidad máxima; inténtelo de nuevo más tarde.
CAPTIONS_LANGUAGE_LIMIT409noHay demasiados idiomas de subtítulos en esta sala.
CAPTIONS_NOT_PERMITTED403noEs posible que el participante no utilice subtítulos.
INVALID_LANGUAGE400noEl código de idioma no es compatible.

CódigoHTTPSe puede volver a intentarSignificado
DESTINATION_LIMIT409noLa organización ha alcanzado el número máximo de destinos de almacenamiento.
DESTINATION_ADMIN_DISABLED403noCHAMPREP El servicio de asistencia ha desactivado este destino de almacenamiento; el cliente no puede volver a activarlo.
ENDPOINT_NOT_ALLOWED400noEl punto final compatible con S3 no está permitido (solo HTTPS en el puerto 443 a una dirección pública).
REDELIVERY_LIMIT429Sí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_DESTINATION409noNo hay ningún destino de almacenamiento activo asociado a esta grabación.
EGRESS_UNAVAILABLE503SíNo se ha podido contactar con el servicio de facturación para cubrir esta descarga; inténtelo de nuevo en breve.
DELIVERY_NOT_CONFIGURED503noLos 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_UNAVAILABLE503noEl almacenamiento de claves de destino aún no está disponible; utilice un rol de AWS.
CódigoHTTPSe puede volver a intentarSignificado
WEBHOOK_NOT_CONFIGURED409noNo hay ningún punto final de webhook configurado.
WEBHOOK_URL_INVALID400noLa URL del webhook no es un punto final HTTPS público en el puerto 443 fuera de los dominiosCHAMPREP.
WEBHOOK_ENDPOINT_LIMIT409noSe ha alcanzado el número de puntos finales de webhook del plan (details.limit, details.used).
WEBHOOK_ENDPOINT_NOT_FOUND404noEl punto final del webhook no existe.
WEBHOOK_ENDPOINT_DISABLED409noEl punto final del webhook está desactivado; actívelo primero.
WEBHOOK_ENDPOINT_ADMIN_DISABLED403noCHAMPREP El servicio de asistencia ha desactivado el punto final del webhook; póngase en contacto con el servicio de asistencia.
WEBHOOK_URL_ADMIN_DISABLED403noCHAMPREP 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_UNKNOWN400noUn filtro de eventos no coincide con ningún tipo de evento conocido (details.patterns).
REPLAY_LIMIT409noEsta entrega se ha repetido demasiadas veces.
REPLAY_QUOTA429SíDemasiadas repeticiones; espere a que Retry-After segundos.
DELIVERY_IN_PROGRESS409SíEl envío se está realizando en este momento.

CódigoHTTPSe puede volver a intentarSignificado
WHITEBOARD_UNAVAILABLE503SíEl servicio de pizarra no está disponible.
WHITEBOARD_DISABLED403noLas pizarras están desactivadas para esta cuenta.
WHITEBOARD_ARCHIVED409noLa pizarra está archivada.
WHITEBOARD_LIMIT409noLa sala ha alcanzado el número máximo de pizarras.
WHITEBOARD_QUOTA402noSe ha agotado el cupo de pizarras blancas.
WHITEBOARD_FILE_INVALID422noNo se ha podido leer el archivo de la pizarra.
WHITEBOARD_FILE_LIMIT409noLa pizarra ha alcanzado el número máximo de archivos.
WHITEBOARD_FILE_PENDING409SíLa carga del archivo de la pizarra no ha finalizado.
WHITEBOARD_FILE_SIZE400noEl tamaño de archivo declarado no es válido.
WHITEBOARD_FILE_TOO_LARGE413noEl archivo de la pizarra es demasiado grande.
WHITEBOARD_FILE_TYPE415noNo se permite el tipo de archivo de pizarra.
SNAPSHOT_TOO_LARGE413noLa captura de pantalla de la pizarra es demasiado grande para enviarla.

CódigoHTTPSe puede volver a intentarSignificado
RC_BLOCKED403noEl control remoto está bloqueado.
RC_CLIPBOARD_OFF403noEl uso compartido del portapapeles está desactivado.
RC_CLIPBOARD_TOO_LARGE413noEl contenido del portapapeles es demasiado grande.
RC_CONFLICT409noExiste un conflicto con otra solicitud de control remoto.
RC_INVALID_REQUEST400noLa solicitud de control remoto no es válida.
RC_NOT_PERMITTED403noNo se permite el control remoto.
RC_NO_BUDGET402noNo quedan derechos de control remoto disponibles.
RC_PENDING409noYa hay una solicitud de control remoto pendiente.
RC_RATE_LIMITED429SíDemasiadas solicitudes de control remoto.
RC_REAUTH_REQUIRED401noVuelva a autenticarse para continuar con el control remoto.
RC_SHARER_BUSY409noEl usuario que comparte ya está bajo control.
RC_UNAVAILABLE404noEl control remoto no está disponible.
RC_WIDEN_REFUSED403noNo es posible ampliar el permiso de control remoto.

CódigoHTTPSe puede volver a intentarSignificado
INVALID_TELEMETRY400noLa muestra de telemetría no es válida.
TELEMETRY_RATE_LIMITED429SíDemasiadas muestras de telemetría.