Referencia de errores del SDK
Esta página ofrece una referencia completa de todos los tipos y códigos de error que pueden aparecer al utilizar el Vonage Client SDK. Comprender estos errores te ayudará a implementar un manejo adecuado de los errores en tu aplicación.
Estructura de errores
Todos los errores del Client SDK son instancias de VonageError con las siguientes propiedades:
| Propiedad | Tipo | Descripción |
|---|---|---|
type |
string |
La categoría del error (véase «Tipos de error» más abajo) |
code |
string |
Código de error específico que identifica el error exacto |
message |
string |
Descripción del error en lenguaje comprensible para las personas |
Tipos de error
El SDK utiliza las siguientes categorías de tipos de error:
| Tipo de error | Descripción |
|---|---|
CS_ERROR |
Errores del servicio de backend (errores de API de los servicios de backend de Vonage) |
SESSION_ERROR |
Errores relacionados con la autenticación y la sesión |
NETWORK_ERROR |
Problemas de conectividad de red, tiempos de espera agotados y errores HTTP 5xx del servidor |
INTERNAL_ERROR |
Errores generados por el SDK, incluidos errores relacionados con los archivos multimedia, la validación y el análisis sintáctico |
UNKNOWN_ERROR |
Errores inesperados que deben comunicarse al servicio de asistencia técnica |
Referencia completa de códigos de error
Códigos CS_ERROR
Errores del servicio de backend devueltos por la API de Vonage:
| Código de error | Código HTTP | Descripción |
|---|---|---|
http:error:db-unavailable |
500 | La base de datos no está disponible temporalmente |
http:error:service-not-available |
503 | El servicio no está disponible temporalmente |
http:error:not-found |
404 | El punto final no existe o no tienes acceso a él |
Códigos SESSION_ERROR
Errores de autenticación y autorización:
| Código de error | Descripción |
|---|---|
internal:auth:authorization_error |
Token de autorización no válido o ausente |
system:error:expired-token |
El token facilitado ha caducado |
system:error:invalid-token |
El token facilitado no es válido |
system:error:missing-token |
No se ha facilitado ningún token |
Códigos de ERROR DE RED
Errores de red y conectividad:
| Código de error | Código HTTP | Descripción |
|---|---|---|
internal:error:serviceNotAvailable |
503 | El servicio no está disponible temporalmente; se recomienda volver a intentarlo. |
http:error:internal |
500 | Error interno del servidor. Inténtalo de nuevo dentro de un rato. |
Códigos de ERROR_INTERNO
Errores generados por el SDK, incluidos los relacionados con los archivos multimedia, la validación y el análisis sintáctico:
Errores en los medios de comunicación
| Código de error | Descripción |
|---|---|
voice:error:media_timeout |
No se ha podido establecer la conexión con el dispositivo dentro del plazo de espera |
voice:error:no_call_found |
No se ha encontrado ninguna llamada de emergencia con el identificador de llamada especificado. |
voice:error:no_call_media_found |
No se ha encontrado ningún medio de llamada para la llamada especificada |
voice:error:no_offer_found |
No se ha generado ninguna oferta SDP para la llamada |
voice:error:no_answer_found |
No se ha recibido ninguna respuesta SDP a la llamada |
media:error:media_not_found |
No se ha encontrado ninguna conexión multimedia para el ID de llamada especificado |
media:error:peer_connection_not_found |
No se ha encontrado la conexión entre pares de WebRTC para el ID de llamada especificado |
media:error:track_not_found |
No se ha encontrado la pista de audio correspondiente al ID de llamada especificado |
media:error:create_answer_error |
No se ha podido crear la respuesta SDP |
media:error:create_offer_error |
No se ha podido crear la oferta SDP |
media:error:create_media_error |
No se ha podido crear el soporte local |
media:error:process_answer_error |
No se ha podido procesar la respuesta SDP |
media:error:process_offer_error |
No se ha podido procesar la oferta SDP |
media:error:audio_transformer_error |
Error en el procesamiento o la transformación del audio |
media:error:noise_suppression_already_enabled |
La supresión de ruido ya está activada |
media:error:noise_suppression_already_disabled |
La supresión de ruido ya está desactivada |
media:error:noise_suppression_models_not_found |
No se han encontrado modelos con supresión de ruido |
Errores de validación y análisis sintáctico
| Código de error | Descripción |
|---|---|
internal:error:parsing_exception |
No se ha podido analizar la respuesta del servidor |
internal:error:unsanitized_input_error |
La solicitud contiene datos de entrada no validados y ha sido rechazada |
internal:error:illegal_argument_exception |
Se han pasado argumentos incorrectos al método |
internal:error:unexpected_null_value |
Se ha detectado un valor nulo inesperado |
Errores específicos de situaciones de emergencia
| Código de error | Descripción |
|---|---|
emergency:error:invalid_reconnect_token_origin |
Falta el token de reconexión o su origen no es válido |
emergency:error:call_timeout |
Se ha agotado el tiempo de espera de la llamada de emergencia |
ERROR DESCONOCIDO
| Código de error | Descripción |
|---|---|
| N/A | Error inesperado que no encaja en ninguna otra categoría; debe comunicarse al servicio de asistencia técnica |