Référence des erreurs du SDK

Cette page fournit une référence complète de tous les types d'erreurs et codes d'erreur pouvant être renvoyés lors de l'utilisation du Vonage Client SDK. La compréhension de ces erreurs vous aidera à mettre en place une gestion des erreurs adéquate dans votre application.

Structure des erreurs

Toutes les erreurs du Client SDK sont des instances de VonageError présentant les propriétés suivantes :

Propriété Type Description
type string La catégorie d'erreur (voir « Types d'erreurs » ci-dessous)
code string Code d'erreur spécifique identifiant l'erreur exacte
message string Description de l'erreur en langage clair

Types d'erreurs

Le SDK utilise les catégories de types d'erreurs suivantes :

Type d'erreur Description
CS_ERROR Erreurs des services backend (erreurs d'API provenant des services backend de Vonage)
SESSION_ERROR Erreurs liées à l'authentification et à la session
NETWORK_ERROR Problèmes de connectivité réseau, délais d'expiration et erreurs serveur HTTP 5xx
INTERNAL_ERROR Erreurs générées par le SDK, notamment les erreurs liées aux médias, à la validation et à l'analyse syntaxique
UNKNOWN_ERROR Erreurs imprévues à signaler au service d'assistance

Référence complète des codes d'erreur

Codes CS_ERROR

Erreurs du service backend renvoyées par l'API Vonage :

Code d'erreur Code HTTP Description
http:error:db-unavailable 500 La base de données est temporairement indisponible
http:error:service-not-available 503 Le service est temporairement indisponible
http:error:not-found 404 Le point de terminaison n'existe pas ou vous n'y avez pas accès

Codes d'erreur de session

Erreurs d'authentification et d'autorisation :

Code d'erreur Description
internal:auth:authorization_error Jeton d'autorisation non valide ou manquant
system:error:expired-token Le jeton fourni a expiré
system:error:invalid-token Le jeton fourni n'est pas valide.
system:error:missing-token Aucun jeton n'a été fourni

Codes d'erreur réseau

Erreurs de réseau et de connectivité :

Code d'erreur Code HTTP Description
internal:error:serviceNotAvailable 503 Le service est temporairement indisponible. Il est recommandé de réessayer.
http:error:internal 500 Erreur interne du serveur. Veuillez réessayer dans quelques instants.

Codes d'erreur internes

Erreurs générées par le SDK, notamment les problèmes liés aux médias, à la validation et à l'analyse syntaxique :

Erreurs liées aux supports

Code d'erreur Description
voice:error:media_timeout La connexion au support n'a pas pu être établie dans le délai imparti.
voice:error:no_call_found Aucun appel d'urgence n'a été trouvé avec l'identifiant d'appel indiqué.
voice:error:no_call_media_found Aucun média d'appel n'a été trouvé pour l'appel spécifié
voice:error:no_offer_found Aucune offre SDP n'a été générée pour cet appel
voice:error:no_answer_found Aucune réponse SDP n'a été reçue pour cet appel
media:error:media_not_found Connexion multimédia introuvable pour l'identifiant d'appel indiqué
media:error:peer_connection_not_found Connexion entre pairs WebRTC introuvable pour l'identifiant d'appel spécifié
media:error:track_not_found Piste audio introuvable pour l'identifiant d'appel indiqué
media:error:create_answer_error Échec de la création de la réponse SDP
media:error:create_offer_error Échec de la création de l'offre SDP
media:error:create_media_error Échec de la création d'un support local
media:error:process_answer_error Échec du traitement de la réponse SDP
media:error:process_offer_error Échec du traitement de l'offre SDP
media:error:audio_transformer_error Erreur lors du traitement/de la transformation audio
media:error:noise_suppression_already_enabled La suppression du bruit est déjà activée
media:error:noise_suppression_already_disabled La suppression du bruit est déjà désactivée
media:error:noise_suppression_models_not_found Aucun modèle avec suppression du bruit n'a été trouvé

Erreurs de validation et d'analyse syntaxique

Code d'erreur Description
internal:error:parsing_exception Échec de l'analyse de la réponse du serveur
internal:error:unsanitized_input_error La requête contient des données non validées et a été rejetée
internal:error:illegal_argument_exception Arguments incorrects fournis à la méthode
internal:error:unexpected_null_value Valeur nulle inattendue détectée

Erreurs spécifiques aux situations d'urgence

Code d'erreur Description
emergency:error:invalid_reconnect_token_origin Le jeton de reconnexion est manquant ou son origine n'est pas valide
emergency:error:call_timeout Dépassement du délai d'attente pour l'appel d'urgence

ERREUR INCONNUE

Code d'erreur Description
N/A Erreur inattendue ne correspondant à aucune autre catégorie — à signaler au service d'assistance