Referência de erros do SDK

Esta página oferece uma referência abrangente de todos os tipos e códigos de erro que podem ser retornados ao usar o Vonage Client SDK. Compreender esses erros ajudará você a implementar um tratamento adequado de erros em seu aplicativo.

Estrutura de erros

Todos os erros no Client SDK são instâncias de VonageError com as seguintes propriedades:

Propriedade Tipo Descrição
type string A categoria do erro (consulte “Tipos de erros” abaixo)
code string Código de erro específico que identifica o erro exato
message string Descrição do erro em linguagem compreensível para o usuário

Tipos de erros

O SDK utiliza as seguintes categorias de tipos de erros:

Tipo de erro Descrição
CS_ERROR Erros no serviço de back-end (erros de API provenientes dos serviços de back-end da Vonage)
SESSION_ERROR Erros relacionados à autenticação e à sessão
NETWORK_ERROR Problemas de conectividade de rede, tempos limite e erros de servidor HTTP 5xx
INTERNAL_ERROR Erros gerados pelo SDK, incluindo erros de mídia, validação e problemas de análise
UNKNOWN_ERROR Erros inesperados que devem ser comunicados ao suporte técnico

Referência completa de códigos de erro

Códigos CS_ERROR

Erros do serviço de back-end retornados pela API da Vonage:

Código de erro Código HTTP Descrição
http:error:db-unavailable 500 O banco de dados está temporariamente indisponível
http:error:service-not-available 503 O serviço está temporariamente indisponível
http:error:not-found 404 O endpoint não existe ou você não tem acesso a ele

Códigos SESSION_ERROR

Erros de autenticação e autorização:

Código de erro Descrição
internal:auth:authorization_error Token de autorização inválido ou ausente
system:error:expired-token O token fornecido expirou
system:error:invalid-token O token fornecido é inválido
system:error:missing-token Nenhum token foi fornecido

Códigos de ERRO DE REDE

Erros de rede e conectividade:

Código de erro Código HTTP Descrição
internal:error:serviceNotAvailable 503 O serviço está temporariamente indisponível; recomenda-se tentar novamente
http:error:internal 500 Erro interno do servidor. Tente novamente em breve

Códigos de ERRO INTERNO

Erros gerados pelo SDK, incluindo problemas relacionados a mídia, validação e análise sintática:

Erros de mídia

Código de erro Descrição
voice:error:media_timeout Não foi possível estabelecer a conexão com a mídia dentro do período de tempo limite
voice:error:no_call_found Não foi encontrada nenhuma chamada de emergência com o ID de chamada especificado
voice:error:no_call_media_found Não foi encontrada nenhuma mídia de chamada para a chamada especificada
voice:error:no_offer_found Não foi gerada nenhuma oferta SDP para a chamada
voice:error:no_answer_found Não foi recebida nenhuma resposta do SDP para a chamada
media:error:media_not_found Não foi encontrada conexão de mídia para o ID de chamada especificado
media:error:peer_connection_not_found Não foi encontrada uma conexão entre pares WebRTC para o ID de chamada especificado
media:error:track_not_found Não foi encontrada nenhuma faixa de áudio para o ID da chamada especificado
media:error:create_answer_error Falha ao criar a resposta SDP
media:error:create_offer_error Falha ao criar a oferta SDP
media:error:create_media_error Falha ao criar mídia local
media:error:process_answer_error Falha ao processar a resposta SDP
media:error:process_offer_error Falha ao processar a oferta SDP
media:error:audio_transformer_error Erro no processamento/transformação de áudio
media:error:noise_suppression_already_enabled A supressão de ruído já está ativada
media:error:noise_suppression_already_disabled A supressão de ruído já está desativada
media:error:noise_suppression_models_not_found Não foram encontrados modelos com supressão de ruído

Erros de validação e análise sintática

Código de erro Descrição
internal:error:parsing_exception Falha ao analisar a resposta do servidor
internal:error:unsanitized_input_error A solicitação contém dados de entrada não sanitizados e foi rejeitada
internal:error:illegal_argument_exception Foram fornecidos argumentos incorretos ao método
internal:error:unexpected_null_value Encontrado um valor nulo inesperado

Erros específicos de emergência

Código de erro Descrição
emergency:error:invalid_reconnect_token_origin O token de reconexão está faltando ou possui uma origem inválida
emergency:error:call_timeout O tempo de espera da chamada de emergência expirou

ERRO DESCONHECIDO

Código de erro Descrição
N/A Erro inesperado que não se enquadra em nenhuma outra categoria — deve ser relatado ao suporte