Fehlerbehandlung
Lernen Sie, wie Sie API-Fehler in Ihrer Anwendung elegant behandeln können.
Wenn bei einer API-Anfrage ein Fehler auftritt, sendet AllNewsAPI eine JSON-Fehlerantwort mit einem Statuscode und einem standardisierten Envelope. Der Antworttext enthält stets ein Detailobjekt mit einem Nachrichtenfeld, das die Fehlerursache beschreibt. Dieser Leitfaden erläutert die einzelnen Fehler und deren Behebung.
Fehlerantwortformat
Alle API-Fehlerantworten (4xx und 5xx) verwenden ein einheitliches JSON-Format. Das Feld „detail.message“ enthält stets eine lesbare Fehlerbeschreibung.
Fehlercodes
400 Fehlerhafte Anfrage
Ihre Anfrage ist fehlerhaft oder enthält nicht die erforderlichen Parameter. Überprüfen Sie Ihre Abfrageparameter und versuchen Sie es erneut.
401 Nicht autorisiert
Ihr API-Schlüssel ist ungültig oder fehlt. Bitte überprüfen Sie, ob Ihr API-Schlüssel korrekt ist und in der Anfrage enthalten ist.
403 Verboten
Ihr Konto hat keine Berechtigung für diese Anfrage. Dies kann vorkommen, wenn Sie versuchen, mit einem kostenlosen Tarif auf Premium-Funktionen zuzugreifen.
429 Zu viele Anfragen
Sie haben Ihr tägliches Anfragelimit überschritten. Warten Sie, bis das Limit um 00:00 UTC zurückgesetzt wird, oder aktualisieren Sie Ihren Tarif.
503 Dienst nicht verfügbar
Die API ist aufgrund von Wartungsarbeiten vorübergehend nicht verfügbar. Bitte versuchen Sie es in wenigen Minuten erneut.
Beispiel:
Bewährte Verfahren zur Fehlerbehandlung
- Prüfen Sie vor der Datenverarbeitung immer den Antwortstatuscode.
- Implementieren Sie exponentielles Backoff für die Wiederholung fehlgeschlagener Anfragen.
- Extrahieren Sie die Fehlermeldung aus response.detail.message für eine benutzerfreundliche Fehleranzeige.