Hier ist eine Liste von 10 typischen Fehlermeldungen, die bei API-Schnittstellen auftreten können, sowie deren Bedeutung und mögliche Lösungshinweise:
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:
Abfragen mehrerer Komponenten und Auflistung in einem API Call: Mehrere Komponenten in einem API Call abfragen
Abfragen von Daten über mehrere Epochen hinweg: Daten mit xComponentIds abfragen
Fehlendes Zeitintervall der Datenabfrage: Werte für Tage, Monate und Jahre abfragen
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.
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:
Stefanie Domzig Seiten Verlinkung prüfen wenn umgezogen
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.
Links zur Paket-Beschreibung:
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.
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.
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 beachten Sie die API-Nutzungsrichtlinien.versuchen Sie ggf. mehrere Daten über einen Call abzufragen.
Abfragen mehrerer Komponenten und Auflistung in einem API Call: Mehrere Komponenten in einem API Call abfragen
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 oder wenden Sie sich an den API-Anbieter, um das Problem zu melden.. Sollte der Fehler weiterhin auftreten, überprüfen Sie unsere Hilfe Seite mit dem aktuellen Status unserer Systeme: Portal Status
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.