Antwortnachrichten

Online bearbeiten

Informationen zu den verschiedenen Fehlern und Rückmeldungen, die von den Verify-Anwendungsprogrammierschnittstellen (APIs) zurückgegeben werden.

HTTP-Statuscodes geben an, ob eine Operation erfolgreich ist oder nicht. Die folgenden Fehlerarten können auftreten, wenn Sie Anfragen an die Verify APIs senden und Antworten von diesen erhalten:

2xx Erfolg: Gibt den Erfolgsstatus der Operation an.
4xx Clientfehler: Gibt ein Problem mit der von der Clientanwendung übergebenen Anforderung an. Beheben Sie das Problem in der Anforderung, bevor Sie die Anforderung erneut übergeben.
5xx Serverfehler: Gibt ein Problem mit dem Server an. Übergeben Sie die Anforderung erneut oder wiederholen Sie die Anforderung, bis sie erfolgreich ausgeführt wird.

Der Hauptteil der Antwort enthält eine Nachrichten-ID (messageId) und Text, der in die Ländereinstellung des Anforderers übersetzt wird (messageDescription).

Tabelle 1. Antwortnachrichten
HTTP-Statuscode	Beschreibung
200	Erfolgreicher Abruf eines Objekts
201	Erfolgreiche Erstellung eines Objekts
202	Anforderung wurde akzeptiert, aber nicht ausgeführt (asynchrone Operation).
204	Angeforderte Operation, wie beispielsweise das Aktualisieren oder Löschen eines Objekts, war erfolgreich.
207	Multi-Status - eine Kombination aus Ergebnissen wurde zurückgegeben. Dieser Status kann bei Operationen PATCH und bei Massenoperationen auftreten.
400	Fehlerhafte Anforderung. Die Anforderung war fehlerhaft oder kann nicht verarbeitet werden. Möglicherweise enthalten die Eingabeparameter ungültige Werte.
401	Der Client wurde nicht authentifiziert. Beispielsweise ist das verwendete Zugriffstoken nicht gültig.
403	Verbotener Zugriff. Beispielsweise ermöglicht das Zugriffstoken nicht den Zugriff auf die angeforderte Ressource.
404	Ressource wurde nicht gefunden. Die angeforderten Informationen sind nicht vorhanden.
405	In der Anforderung angegebene HTTP-Methode wird von der Ressource nicht unterstützt.
406	Die Ressource kann die im Header "Accept" der Anforderung angegebene Darstellung nicht erstellen.
409	Die Informationen sind vorhanden.
415	Die Ressource kann die im Header "Content-Type" der Anforderung angegebene Darstellung nicht lesen.
429	Zu viele Anforderungen
500	Bei der Verarbeitung der Anforderung ist ein interner Serverfehler aufgetreten.
501	Die angeforderte Methode wurde inaktiviert.
502	Benachrichtigung wurde nicht gesendet.

Wenn alle Operationen während Operationen des Typs PATCH erfolgreich sind, wird der Status

zurückgegeben. Wenn ein oder mehrere Fehler auftreten, wird der Status 207 zurückgegeben und die Ergebnisse können vom Client geparst werden.

Wenn alle Operationen während Managementmassenoperationen wie POST oder DELETE erfolgreich sind, wird der Status

zurückgegeben. Wenn ein oder mehrere Fehler auftreten, wird der Status 207 zurückgegeben und die Ergebnisse können vom Client geparst werden.

Verwenden Sie zur Fehlerbehandlung den HTTP-Antwortcode und die Nachrichten-ID (messageId) aus dem Fehlerantworthauptteil. Die Nachrichtenbeschreibung (messageDescription) dient nur zur Information und unterliegt Änderungen. Keine dieser Änderungen stellt eine Änderung an der Semantik der API dar.