Error Messages

Owned by Simon Schweda
Last updated: Sept 23, 2024 by Stefanie Domzig
3 min read

Hier ist eine Liste von 10 typischen Fehlermeldungen, die bei API-Schnittstellen auftreten können, sowie deren Bedeutung und mögliche Lösungshinweise:

 

  1. Fehler 400 - Bad Request

Bedeutung: Die Anfrage des Clients war ungültig oder fehlerhaft. Dies kann durch fehlende Parameter, falsches Format oder ungültige Werte verursacht werden.

Lösung: Überprüfen Sie die Anfrage auf korrekte Syntax und stellen Sie sicher, dass alle erforderlichen Parameter enthalten sind.

Mögliche Ursachen:

 

 

  1. Fehler 401 - Unauthorized

Bedeutung: Der Client hat keine gültigen Authentifizierungsdaten gesendet oder ist nicht berechtigt, auf die angeforderte Ressource zuzugreifen.

Lösung: Stellen Sie sicher, dass der API-Schlüssel oder das Token gültig ist und ordnungsgemäß gesendet wird. Der generierte Token ist nur 5 Minuten gültig. Sollten Sie einen 401 Fehler erhalten, erneuern Sie Ihren Token über den entsprechenden Call in Ihrer Postman Collection.

 

 

  1. Fehler 403 - Forbidden

Bedeutung: Der Server hat die Anfrage erhalten, aber der Client hat keine Berechtigung, die angeforderte Ressource abzurufen.

Lösung: Überprüfen Sie die Zugriffsrechte und stellen Sie sicher, dass der Benutzer oder das System die erforderlichen Berechtigungen hat. Prüfen Sie hierzu die API Calls, die in Ihrem Paket verfügbar sind.

Links zur Paket-Beschreibung:

 

 

  1. Fehler 404 - Not Found

Bedeutung: Die angeforderte Ressource wurde auf dem Server nicht gefunden. Dies könnte durch eine falsche URL oder eine nicht existierende Ressource verursacht werden.

Lösung: Überprüfen Sie die URL und stellen Sie sicher, dass die Ressource existiert.

  • Prüfen Sie, ob der Portal-Name in der URL korrekt ist. Hierfür nutzen Sie bitte ausschließlich Ihren Portal-Namen. Die Endung “.enerest.world” wird in diesem Fall nicht benötigt.

  • Prüfen Sie, ob der Call, den Sie ausführen in den Paketen enthalten ist.

 

 

  1. Fehler 405 - Method Not Allowed

Bedeutung: Die HTTP-Methode (z.B. GET, POST, PUT, DELETE), die in der Anfrage verwendet wurde, wird für die angeforderte Ressource nicht unterstützt.

Lösung: Überprüfen Sie, welche Methoden für die Ressource erlaubt sind, und verwenden Sie die korrekte Methode. Prüfen Sie, ob die Methode auf GET gesetzt wurde. In den meisten Fällen unserer Quota API werden POST, PUT und DELETE Calls nicht erlaubt.

 

 

  1. Fehler 408 - Request Timeout

Bedeutung: Der Server hat zu lange auf eine Anfrage gewartet und diese daher abgebrochen.

Lösung: Überprüfen Sie die Netzwerkverbindung und versuchen Sie, die Anfrage zu einem späteren Zeitpunkt zu wiederholen.

 

 

  1. Fehler 429 - Too Many Requests

Bedeutung: Der Client hat zu viele Anfragen in kurzer Zeit gesendet und wurde deshalb temporär blockiert (Rate Limiting).

Lösung: Reduzieren Sie die Häufigkeit der Anfragen und versuchen Sie ggf. mehrere Daten über einen Call abzufragen.

 

 

  1. Fehler 500 - Internal Server Error

Bedeutung: Der Server hat einen unerwarteten Fehler festgestellt, der die Verarbeitung der Anfrage verhindert hat. Dies kann z.B. bedeuten, dass der Server zu lange für eine Antwort gebraucht hat und die Anfrage deshalb nicht ausgeführt werden konnte.

Lösung: Versuchen Sie es später erneut. Sollte der Fehler weiterhin auftreten, überprüfen Sie unsere Hilfe Seite mit dem aktuellen Status unserer Systeme: Portal Status

 

 

  1. Fehler 502 - Bad Gateway

Bedeutung: Der Server hat von einem anderen Server, zu dem er Anfragen weiterleitet, eine ungültige Antwort erhalten.

Lösung: Dies ist ein temporäres Problem. Versuchen Sie es später erneut. Sollte der Fehler weiterhin auftreten, überprüfen Sie unsere Hilfe Seite mit dem aktuellen Status unserer Systeme: Portal Status

 

 

10. Fehler 503 - Service Unavailable

Bedeutung: Der Server ist momentan nicht verfügbar, normalerweise aufgrund von Wartungsarbeiten oder Überlastung.

Lösung: Warten Sie eine Weile und versuchen Sie es später erneut. Sollte der Fehler weiterhin auftreten, überprüfen Sie unsere Hilfe Seite mit dem aktuellen Status unserer Systeme: Portal Status

 

 

 

Diese Liste deckt die häufigsten API-Fehler ab, die Entwicklern und Nutzern von API-Diensten begegnen können. Es ist wichtig, den Nutzern klare Hinweise zu geben, wie sie diese Probleme beheben können, um Frustrationen zu vermeiden.