SDK-Fehlerübersicht

Diese Seite bietet eine umfassende Übersicht über alle Fehlertypen und -codes, die bei der Verwendung des Vonage Client SDK zurückgegeben werden können. Das Verständnis dieser Fehler hilft Ihnen dabei, eine ordnungsgemäße Fehlerbehandlung in Ihrer Anwendung zu implementieren.

Fehlerstruktur

Alle Fehler im Client SDK sind Instanzen von VonageError mit den folgenden Eigenschaften:

Eigentum Typ Beschreibung
type string Die Fehlerkategorie (siehe „Fehlertypen“ weiter unten)
code string Spezifischer Fehlercode, der den genauen Fehler identifiziert
message string Für Menschen verständliche Fehlerbeschreibung

Fehlertypen

Das SDK verwendet die folgenden Fehlerkategorien:

Fehlertyp Beschreibung
CS_ERROR Fehler bei Backend-Diensten (API-Fehler von Vonage-Backend-Diensten)
SESSION_ERROR Fehler bei der Authentifizierung und im Zusammenhang mit Sitzungen
NETWORK_ERROR Probleme mit der Netzwerkverbindung, Timeouts und HTTP-5xx-Serverfehler
INTERNAL_ERROR Vom SDK generierte Fehler, darunter Medienfehler, Validierungs- und Parsing-Probleme
UNKNOWN_ERROR Unerwartete Fehler, die dem Support gemeldet werden sollten

Vollständige Fehlercode-Übersicht

CS_ERROR-Codes

Von der Vonage-API zurückgegebene Backend-Dienstfehler:

Fehlercode HTTP-Code Beschreibung
http:error:db-unavailable 500 Die Datenbank ist vorübergehend nicht verfügbar
http:error:service-not-available 503 Der Dienst ist vorübergehend nicht verfügbar
http:error:not-found 404 Der Endpunkt existiert nicht oder Sie haben keinen Zugriff darauf

SESSION_ERROR-Codes

Fehler bei der Authentifizierung und Autorisierung:

Fehlercode Beschreibung
internal:auth:authorization_error Ungültiges oder fehlendes Autorisierungstoken
system:error:expired-token Das angegebene Token ist abgelaufen
system:error:invalid-token Das angegebene Token ist ungültig
system:error:missing-token Es wurde kein Token angegeben

NETWORK_ERROR-Codes

Netzwerk- und Verbindungsfehler:

Fehlercode HTTP-Code Beschreibung
internal:error:serviceNotAvailable 503 Der Dienst ist vorübergehend nicht verfügbar. Ein erneuter Versuch wird empfohlen.
http:error:internal 500 Interner Serverfehler, bitte versuchen Sie es in Kürze erneut

INTERNAL_ERROR-Codes

Vom SDK generierte Fehler, darunter Probleme mit Medien, der Validierung und der Analyse:

Medienfehler

Fehlercode Beschreibung
voice:error:media_timeout Die Medienverbindung konnte nicht innerhalb der Zeitüberschreitungsdauer hergestellt werden
voice:error:no_call_found Es wurde kein Notruf mit der angegebenen Anruf-ID gefunden.
voice:error:no_call_media_found Für den angegebenen Anruf wurden keine Anrufdaten gefunden
voice:error:no_offer_found Für den Anruf wurde kein SDP-Angebot generiert
voice:error:no_answer_found Für den Anruf ging keine SDP-Antwort ein
media:error:media_not_found Für die angegebene Anruf-ID wurde keine Medienverbindung gefunden
media:error:peer_connection_not_found Für die angegebene Anruf-ID wurde keine WebRTC-Peer-Verbindung gefunden
media:error:track_not_found Für die angegebene Anruf-ID wurde keine Audiospur gefunden
media:error:create_answer_error SDP-Antwort konnte nicht erstellt werden
media:error:create_offer_error SDP-Angebot konnte nicht erstellt werden
media:error:create_media_error Das Erstellen des lokalen Speichermediums ist fehlgeschlagen
media:error:process_answer_error Die Verarbeitung der SDP-Antwort ist fehlgeschlagen
media:error:process_offer_error Die Verarbeitung des SDP-Angebots ist fehlgeschlagen
media:error:audio_transformer_error Fehler bei der Audioverarbeitung/-umwandlung
media:error:noise_suppression_already_enabled Die Rauschunterdrückung ist bereits aktiviert
media:error:noise_suppression_already_disabled Die Rauschunterdrückung ist bereits deaktiviert
media:error:noise_suppression_models_not_found Modelle zur Geräuschunterdrückung wurden nicht gefunden

Validierungs- und Parsing-Fehler

Fehlercode Beschreibung
internal:error:parsing_exception Die Antwort vom Server konnte nicht analysiert werden
internal:error:unsanitized_input_error Die Anfrage enthält ungeprüfte Eingaben und wurde abgelehnt
internal:error:illegal_argument_exception Der Methode wurden falsche Argumente übergeben
internal:error:unexpected_null_value Es wurde ein unerwarteter Nullwert festgestellt

Notfallspezifische Fehler

Fehlercode Beschreibung
emergency:error:invalid_reconnect_token_origin Das Token zur erneuten Verbindung fehlt oder hat eine ungültige Herkunft
emergency:error:call_timeout Zeitlimit für den Notrufvorgang abgelaufen

UNKNOWN_ERROR

Fehlercode Beschreibung
K.A. Unerwarteter Fehler, der in keine andere Kategorie passt – sollte dem Support gemeldet werden