Fehler

LocaleUI.com verwendet standardisierte HTTP-Statuscodes zur Kennzeichnung des Erfolgs oder Fehlers einer Anfrage.

Erfolgreiche Anfragen resultieren in Codes des 2xx-Bereichs, während Client-Fehler mit 4xx-Codes signalisiert werden.

Fehlerantworten werden im JSON-Format zurückgegeben und enthalten detaillierte Informationen, beispielsweise zu fehlenden, ungültigen oder nicht autorisierten Parametern.

Beispiel für eine Fehlerantwort

      
        GET 
        /api/v1/projects/[Ungültige Projekt API ID]
        404 Not found
      {
  "message": "Cannot find record",
  "detail": "Couldn't find Project with ..."
}

Die dargestellte API Antwort zeigt den Fehler beim Aufruf des Projekt-Endpunkts mit gültiger Authentifizierung aber ungültiger Projekt API ID.

Fehlercodes

Die API gibt standardisierte Fehlermeldungen zurück, die den Fehlercode und eine Beschreibung des Fehlers enthalten. Hier sind einige häufige Fehlercodes:

Status

Beschreibung

400

Bad Request

Die Anfrage war ungültig oder nicht korrekt formatiert. Dies kann passieren, wenn erforderliche Parameter fehlen oder ungültig sind.

401

Unauthorized

Die Anfrage erfordert eine Authentifizierung oder der angegebene API-Schlüssel ist ungültig.

403

Forbidden

Die Anfrage war gültig, aber der Benutzer hat keine Berechtigung zum Zugriff auf die angeforderte Ressource.

404

Not Found

Die angeforderte Ressource wurde nicht gefunden. Dies kann passieren, wenn die Ressource nicht existiert oder die URL falsch ist.

500

Internal Server Error

Auf dem Server ist ein unerwarteter Fehler aufgetreten. Dies kann passieren, wenn ein Fehler in der API vorliegt oder wenn der Server überlastet ist.