API-Fehlercodes
Die API gibt strukturierte Fehlercodes zurück, die einer HTTP-Fehlerklasse zugeordnet sind. Jeder Code besteht aus der Fehlerklasse und einer laufenden Nummer (z.B. 40102 = Klasse 401, Code 02).
Fehlerklassen
| Klasse |
Beschreibung |
| 100 |
Informationelle Rückmeldungen |
| 200 |
Erfolgreiche Operationen |
| 201 |
Erfolgreiche Erstellungen |
| 300 |
Warnungen und veraltete Funktionen |
| 400 |
Fehlerhafte Anfragen |
| 401 |
Authentifizierungsfehler |
| 403 |
Berechtigungsprobleme |
| 404 |
Ressource nicht gefunden |
| 405 |
Methode nicht erlaubt |
| 415 |
Nicht unterstütztes Content-Format |
| 429 |
Rate-Limit erreicht |
| 500 |
Interner Serverfehler |
| 530 |
Sicherheitsfehler |
| Code |
Bedeutung |
| 10001 |
Vorgang fortsetzen (Continue) |
| 10002 |
Keine Änderung durchgeführt (No Change) |
| 10003 |
Nur Leseoperation (Read Only Performed) |
| 10004 |
Standardwerte angewendet (Default Values Applied) |
| 10005 |
Vorgang in Warteschlange (Operation Queue Started) |
| 10006 |
Keine Daten vorhanden (No Data) |
200 – Erfolgreiche Operationen
| Code |
Bedeutung |
| 20001 |
OK – Anfrage erfolgreich |
| 20002 |
Update erfolgreich |
| 20003 |
Löschung erfolgreich |
| 20101 |
Ressource erfolgreich erstellt |
300 – Warnungen
| Code |
Bedeutung |
| 30001 |
Allgemeine Warnung |
| 30002 |
Funktion veraltet (Deprecated) |
400 – Fehlerhafte Anfragen
| Code |
Bedeutung |
| 40001 |
Allgemeiner Fehler (Bad Request) |
| 40002 |
Validierungsfehler |
| 40003 |
Pflichtfeld fehlt (Missing Required Field) |
| 40004 |
Ungültiges Format (Invalid Format) |
| 40005 |
Unzureichendes Guthaben (Insufficient Funds) |
401 – Authentifizierungsfehler
| Code |
Bedeutung |
| 40101 |
Token fehlt (Missing Token) |
| 40102 |
Token ungültig (Invalid Token) |
| 40103 |
Benutzer nicht gefunden (User Not Found) |
403 – Berechtigungsprobleme
| Code |
Bedeutung |
| 40301 |
Unzureichende Berechtigungen |
| 40302 |
Zugriff verweigert |
| 40303 |
Produkt nicht aktiv |
| 40304 |
Produkt wird installiert |
404 – Ressource nicht gefunden
| Code |
Bedeutung |
| 40401 |
Nicht gefunden (Not Found) |
| 40402 |
Ressource nicht gefunden |
| 40403 |
Produkt nicht gefunden |
405 – Methode nicht erlaubt
| Code |
Bedeutung |
| 40501 |
HTTP-Methode nicht erlaubt |
415 – Content-Format nicht unterstützt
| Code |
Bedeutung |
| 41501 |
Unsupported Media Type |
429 – Rate-Limit
| Code |
Bedeutung |
| 42901 |
Rate-Limit erreicht (Too Many Requests) |
500 – Interner Serverfehler
| Code |
Bedeutung |
| 50001 |
Interner Fehler (Internal Server Error) |
| 50002 |
Datenbankfehler |
| 50003 |
Cache-Fehler |
| 50004 |
Abhängigkeitsfehler |
| 50005 |
Nicht behandelte Ausnahme |
| 50006 |
Konfigurationsfehler |
| 50007 |
Dienst nicht verfügbar |
| 50008 |
Zeitüberschreitung (Timeout) |
| 50009 |
Speicherfehler |
| 50010 |
Kein Windows-Schlüssel verfügbar |
530 – Sicherheitsfehler
| Code |
Bedeutung |
| 53001 |
Allgemeiner Sicherheitsfehler |
| 53002 |
Sicherheitsverletzung |
Fehlersuche
Bei Fehlern prüfe zuerst:
- Ist die Anfrage korrekt formatiert?
- Ist der API-Key gültig und aktiv?
- Hat dein Account die nötigen Berechtigungen?
- Zeigt der API-Debugger Details zum Fehler?
- Gibt es aktuelle Störungen?
Bei weiterhin bestehenden Problemen wende dich an den Reseller-Support.