Pular para o conteúdo
Documentation

Erros do RTC

Cada erro do RTC possui um código estável e legível por máquina código. Baseie-se no código, nunca no texto da mensagem: as mensagens podem ser reformuladas, enquanto os códigos nunca são renomeados ou reutilizados com outro significado.

Padrão. Sem um cabeçalho de versão, os erros mantêm seu formato original, de modo que as integrações existentes não são afetadas:

{ "error": "Your plan allows 2 webhook endpoints", "code": "WEBHOOK_ENDPOINT_LIMIT" }

code está presente em erros que possuem um código específico. Erros mais antigos podem conter apenas ; o cabeçalho sempre indica o código. error; o X-Error-Code O cabeçalho sempre identifica o código.

Envelope estruturado. Enviar RTC-Version: 2026-11-01 com uma solicitação para receber o envelope estruturado:

Terminal window
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 estável do catálogo
messageExplicação legível por humanos; não a analise
detailsContexto estruturado opcional, por exemplo limit e used, ou issues (os campos inválidos) para INVALID_REQUEST
requestIdO ID desta solicitação, também enviado como X-Request-Id
retryabletrue ao tentar novamente a mesma solicitação mais tarde pode ser bem-sucedida
docUrlLink para a entrada deste código abaixo

A resposta reflete a versão aplicada no RTC-Version . Uma data anterior a 2026-11-01 mantém o formato padrão. Consulte versões.

CabeçalhoQuandoSignificado
X-Request-IdToda respostaID exclusivo da solicitação. Inclua-o ao entrar em contato com o suporte.
X-Error-CodeTodo erroO código estável, em ambos os formatos de resposta
Retry-After429e alguns 503Segundos a aguardar antes de tentar novamente
X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-ResetRespostas autenticadasConsulte Limites de taxa

  • retryable: false (4xx que não seja 429): corrija primeiro a solicitação, a credencial, o plano ou o estado. Repetir a solicitação sem alterações resultará na mesma resposta.
  • retryable: true: tente novamente com recuo exponencial e jitter, respeitando Retry-After. Repita as gravações somente quando a operação for idempotente ou após a reconciliação de seu resultado.
  • 401: a credencial está ausente, expirada ou revogada. 403: a credencial é válida, mas não possui escopo, acesso ao projeto ou direito ao plano.
  • 404 também abrange recursos que pertencem a terceiros. Nunca investigue os identificadores de outros clientes.

GET /v1/error-codes (sem autenticação) retorna o catálogo atual como { "codes": [{ "code", "status", "retryable", "description" }] }. Novos códigos podem ser adicionados a qualquer momento; trate um código desconhecido como o código genérico de seu status HTTP.

Códigos genéricos (um por status HTTP, utilizados quando nenhum código específico se aplica)

Seção intitulada “Códigos genéricos (um por status HTTP, utilizados quando nenhum código específico se aplica)”
CódigoHTTPRepetívelSignificado
INVALID_REQUEST400nãoA solicitação está com formato incorreto ou um campo é inválido (details.issues (enumera os campos).
UNAUTHENTICATED401nãoCredenciais ausentes, inválidas ou vencidas.
PAYMENT_REQUIRED402nãoÉ necessário efetuar um pagamento antes que isso possa ser utilizado.
FORBIDDEN403nãoA credencial é válida, mas não está autorizada a realizar essa ação.
NOT_FOUND404nãoO recurso não existe ou não está visível para esta credencial.
CONFLICT409nãoA solicitação entra em conflito com o estado atual.
PAYLOAD_TOO_LARGE413nãoO corpo da solicitação é muito grande.
UNSUPPORTED_MEDIA_TYPE415nãoO tipo de conteúdo não é aceito.
RANGE_NOT_SATISFIABLE416nãoO intervalo de bytes solicitado é inválido ou indisponível.
UNPROCESSABLE422nãoO conteúdo foi compreendido, mas não pode ser processado.
RATE_LIMITED429simExcesso de solicitações; aguarde Retry-After segundos.
INTERNAL500simErro inesperado do servidor; tente novamente mais tarde.
SERVICE_UNAVAILABLE503simTemporariamente indisponível; tente novamente com intervalo de espera.

Essas respostas também incluem offers (o que resolve o problema: um período de teste, uma assinatura, um upgrade, um pacote ou a adição de um cartão, cada um com um link de cobrançaCHAMPREP) e, quando se trata de uma cota ou recurso específico, feature.

CódigoHTTPRepetívelSignificado
RTC_SUBSCRIPTION_REQUIRED402nãoA conta não possui assinatura, período de teste ou cota incluída para o RTC (consulte offers).
RTC_PAYMENT_REQUIRED402nãoUma fatura não paga bloqueia o RTC; pague-a no CHAMPREP Faturamento.
RTC_ACCESS_DENIED403nãoUma política da organização, equipe ou plataforma impede o uso do RTC (reasonCode (especifica qual).
RTC_ALLOWANCE_EXHAUSTED402nãoA cota de RTC da assinatura foi esgotada (feature indica qual; consulte offers).
RTC_FEATURE_NOT_IN_PLAN403nãoA assinatura não inclui este recurso (consulte offers).
RTC_PLAN_LIMIT403nãoFoi atingido um limite da assinatura (tamanho da sala, salas abertas simultaneamente).
PAYMENT_METHOD_REQUIRED402nãoO período de avaliação requer um cartão cadastrado no espaço de trabalho pago (consulte offers).
TRIAL_ALREADY_USED409nãoA avaliação gratuita já foi utilizada por esta conta.
TRIAL_NOT_ALLOWED403nãoEsta conta não pode iniciar o período de avaliação gratuita.
TRIAL_UNAVAILABLE409nãoO período de avaliação gratuita não está disponível.
ALREADY_SUBSCRIBED409nãoA conta já possui uma assinatura RTC.
PRIMARY_TOKEN_REQUIRED401nãoPara iniciar um período de avaliação, é necessária a sessão do console do titular da conta.
PRIMARY_TOKEN_INVALID401nãoA sessão do console não é válida para iniciar um período de avaliação; faça login novamente.
PRIMARY_TOKEN_MISMATCH403nãoSomente o titular da conta pode iniciar este período de avaliação.

CódigoHTTPRepetívelSignificado
INVALID_CURSOR400nãoO cursor está com formato inválido ou pertence a outra lista.
IDEMPOTENCY_KEY_INVALID400nãoO Idempotency-Key O cabeçalho está com formato incorreto.
IDEMPOTENCY_KEY_REUSED409nãoO Idempotency-Key foi utilizado em uma solicitação diferente.
IDEMPOTENCY_IN_PROGRESS409simA primeira solicitação com este Idempotency-Key ainda está em execução.

CódigoHTTPRepetívelSignificado
ROOM_EXTERNAL_REF_CONFLICT409nãoUma sala aberta do projeto já utiliza este externalRef.
ROOM_FULL409nãoA sala atingiu seu limite de participantes.
ROOM_LOCKED409nãoA sala está bloqueada; somente os anfitriões podem entrar.
ROOM_ALLOWANCE_UNAVAILABLE503simNão foi possível ler a cota de participantes da sala.
PARTICIPANT_BANNED409nãoEsta identidade está banida da sala.
PARTICIPANT_REMOVED403nãoEste participante foi removido da sala.
MEDIA_CAPACITY503simNenhum nó de mídia tem espaço para isso no momento; tente novamente mais tarde.
MEDIA_NODE_UNAVAILABLE503simO nó de mídia da sala está indisponível; tente novamente.
MEDIA_UNAVAILABLE503simO serviço de mídia está indisponível; tente novamente.
HOST_MUTED403nãoUm anfitrião silenciou esta fonte.
DATA_NOT_PERMITTED403nãoO participante não pode enviar mensagens do aplicativo.
MESSAGE_TOO_LARGE400nãoA mensagem do aplicativo é muito grande.
MESSAGE_RATE_LIMITED429simHá um número excessivo de mensagens do aplicativo enviadas por este participante.
ROOM_MESSAGE_RATE_LIMITED429simHá um número excessivo de mensagens do aplicativo nesta sala.
RESERVED_TOPIC400nãoO tópico da mensagem do aplicativo está reservado.
INVALID_RECIPIENTS400nãoOs destinatários da mensagem do aplicativo são inválidos.
RESUME_REFUSED403nãoA sessão não pode ser retomada.
RESUME_UNAVAILABLE503simA função de retomada está temporariamente indisponível.
FIRST_PARTY409nãoReservado para os produtos próprios CHAMPREPda .
FIRST_PARTY_NOT_READY503simO locatário primário ainda não foi provisionado.

Tokens de participação e chaves de assinatura do projeto

Seção intitulada “Tokens de participação e chaves de assinatura do projeto”
CódigoHTTPRepetívelSignificado
JOIN_GRANT_INVALID401nãoO token de acesso está inválido, expirado, assinado incorretamente ou sua chave de assinatura foi revogada.
JOIN_GRANT_USED409nãoEste token de participação já foi utilizado (eles são de uso único).
SIGNING_KEY_LIMIT409nãoO projeto já possui o número máximo de chaves de assinatura ativas.
SIGNING_KEY_INVALID400nãoA chave pública não é um JWK P-256 válido.

CódigoHTTPRepetívelSignificado
COMPOSITE_UNAVAILABLE400nãoA gravação composta não está disponível.
DELETE_NOT_AVAILABLE403nãoAs gravações não podem ser excluídas pelos clientes (não são mais enviadas: DELETE /v1/recordings/:id envia a gravação para a Lixeira, onde será excluída automaticamente após 30 dias).
RECORDING_ACTIVE409nãoA gravação ainda está em andamento.
RECORDING_SETTLING409simA gravação ainda está sendo armazenada.
RECORDING_NOT_READY409nãoA gravação ainda não foi concluída (as entregas exigem uma gravação pronta).
RECORDING_NOT_IN_TRASH409nãoSomente uma gravação na Lixeira pode ser excluída permanentemente; exclua-a primeiro.
RECORDING_PURGED409nãoA gravação foi excluída permanentemente (da Lixeira ou por um administrador) e não pode ser restaurada.
CONFIRM_PURGE_REQUIRED400nãoPara reduzir a janela da Lixeira, é necessário definir confirmPurge: true.
TRANSCRIPTION_UNAVAILABLE400nãoNão há transcrições disponíveis para esta conta.
TRANSCRIPT_EXISTS409nãoJá existe uma transcrição desta gravação ou ela está em execução.
NO_AUDIO409nãoA gravação não possui áudio para transcrição.
TRANSCRIPT_NOT_READY409simA transcrição ainda não está concluída; somente uma transcrição concluída pode ser exportada como VTT, SRT ou TXT.
TRANSCRIPT_RUNNING409nãoA transcrição já está sendo gerada e não pode ser cancelada.
TRANSCRIPT_NOT_CANCELLABLE409nãoApenas uma transcrição que ainda não tenha sido iniciada pode ser cancelada.
WINDOW_TOO_LONG400nãoO intervalo de tempo solicitado é muito longo.
SUMMARY_TIMEOUT503simO resumo demorou muito; tente novamente.
CAPTIONS_BUSY503simAs legendas em tempo real estão no limite de capacidade; tente novamente mais tarde.
CAPTIONS_LANGUAGE_LIMIT409nãoHá idiomas de legenda em excesso nesta sala.
CAPTIONS_NOT_PERMITTED403nãoO participante não pode utilizar legendas.
INVALID_LANGUAGE400nãoO código do idioma não é compatível.

CódigoHTTPRepetívelSignificado
DESTINATION_LIMIT409nãoA organização atingiu o número máximo de destinos de armazenamento.
DESTINATION_ADMIN_DISABLED403nãoCHAMPREP O suporte desativou este destino de armazenamento; ele não pode ser reativado pelo cliente.
ENDPOINT_NOT_ALLOWED400nãoO endpoint compatível com S3 não é permitido (HTTPS na porta 443 apenas para um endereço público).
REDELIVERY_LIMIT429simA gravação foi enviada novamente recentemente, ou a organização enviou muitas gravações nesta hora; tente novamente mais tarde.
NO_ACTIVE_DESTINATION409nãoNão há nenhum destino de armazenamento ativo aplicável a esta gravação.
EGRESS_UNAVAILABLE503simNão foi possível acessar o sistema de cobrança para cobrir este download; tente novamente em breve.
DELIVERY_NOT_CONFIGURED503nãoOs destinos de funções da AWS ainda não estão disponíveis; utilize chaves compatíveis com S3 (código e mensagem foram enviados).
CREDENTIALS_UNAVAILABLE503nãoO armazenamento de chaves de destino ainda não está disponível; utilize uma função da AWS.
CódigoHTTPRepetívelSignificado
WEBHOOK_NOT_CONFIGURED409nãoNenhum endpoint de webhook está configurado.
WEBHOOK_URL_INVALID400nãoA URL do webhook não é um endpoint HTTPS público na porta 443 fora dos domíniosCHAMPREP.
WEBHOOK_ENDPOINT_LIMIT409nãoO número de pontos de extremidade de webhook do plano foi atingido (details.limit, details.used).
WEBHOOK_ENDPOINT_NOT_FOUND404nãoO endpoint do webhook não existe.
WEBHOOK_ENDPOINT_DISABLED409nãoO endpoint do webhook está desativado; ative-o primeiro.
WEBHOOK_ENDPOINT_ADMIN_DISABLED403nãoCHAMPREP O suporte desativou o endpoint do webhook; entre em contato com o suporte.
WEBHOOK_URL_ADMIN_DISABLED403nãoCHAMPREP O suporte desativou esta URL de webhook; ela não pode ser adicionada novamente. Entre em contato com o suporte.
WEBHOOK_EVENT_UNKNOWN400nãoUm filtro de evento não corresponde a nenhum tipo de evento conhecido (details.patterns).
REPLAY_LIMIT409nãoEsta entrega foi repetida com muita frequência.
REPLAY_QUOTA429simExcesso de reproduções; aguarde Retry-After segundos.
DELIVERY_IN_PROGRESS409simA entrega está sendo enviada neste momento.

CódigoHTTPRepetívelSignificado
WHITEBOARD_UNAVAILABLE503simO serviço de quadro branco está indisponível.
WHITEBOARD_DISABLED403nãoOs quadros brancos estão desativados para esta conta.
WHITEBOARD_ARCHIVED409nãoO quadro branco está arquivado.
WHITEBOARD_LIMIT409nãoA sala atingiu o número máximo de quadros brancos.
WHITEBOARD_QUOTA402nãoA cota de quadros brancos está esgotada.
WHITEBOARD_FILE_INVALID422nãoNão foi possível ler o arquivo do quadro branco.
WHITEBOARD_FILE_LIMIT409nãoO quadro branco atingiu o número máximo de arquivos.
WHITEBOARD_FILE_PENDING409simO upload do arquivo do quadro branco não foi concluído.
WHITEBOARD_FILE_SIZE400nãoO tamanho do arquivo declarado é inválido.
WHITEBOARD_FILE_TOO_LARGE413nãoO arquivo do quadro branco é muito grande.
WHITEBOARD_FILE_TYPE415nãoO tipo de arquivo do quadro branco não é permitido.
SNAPSHOT_TOO_LARGE413nãoO instantâneo do quadro branco é muito grande para ser retornado.

CódigoHTTPRepetívelSignificado
RC_BLOCKED403nãoO controle remoto está bloqueado.
RC_CLIPBOARD_OFF403nãoO compartilhamento da área de transferência está desativado.
RC_CLIPBOARD_TOO_LARGE413nãoO conteúdo da área de transferência é muito grande.
RC_CONFLICT409nãoHá outro pedido de controle remoto em conflito.
RC_INVALID_REQUEST400nãoA solicitação de controle remoto é inválida.
RC_NOT_PERMITTED403nãoO controle remoto não é permitido.
RC_NO_BUDGET402nãoNão há mais cota de controle remoto disponível.
RC_PENDING409nãoJá há uma solicitação de controle remoto pendente.
RC_RATE_LIMITED429simExcesso de solicitações de controle remoto.
RC_REAUTH_REQUIRED401nãoReautentifique-se para continuar o controle remoto.
RC_SHARER_BUSY409nãoO compartilhador já está sob controle.
RC_UNAVAILABLE404nãoO controle remoto não está disponível.
RC_WIDEN_REFUSED403nãoA autorização de controle remoto não pode ser ampliada.

CódigoHTTPRepetívelSignificado
INVALID_TELEMETRY400nãoA amostra de telemetria está inválida.
TELEMETRY_RATE_LIMITED429simExcesso de amostras de telemetria.