Anleitung · 1 Min. Lesezeit
Fehlercodes
Jeder Fehler, den die API zurückgibt, was er bedeutet und wie du reagierst.
Fehler liefern einen Nicht-2xx-Status und einen JSON-Body mit einem stabilen, maschinenlesbaren code. Verzweige anhand des Codes, nie anhand der Meldung - Meldungen sind für Menschen geschrieben und können sich ändern.
{
"success": false,
"error": {
"code": "insufficient_credits",
"message": "This call costs 10 credits and your balance is 3. Top up to continue.",
"details": null
},
"creditsCharged": 0,
"creditsRemaining": 3
}Referenz
| Status | Code | Bedeutung und Lösung |
|---|---|---|
| 400 | invalid_arguments | Ein Argument fehlt oder hat den falschen Typ. details listet jedes Problem pro Feld auf. Nicht berechnet. |
| 400 | invalid_url | Ein URL-Argument ist keine absolute http-/https-URL. |
| 400 | invalid_hash | Der übergebene Hash hat nicht das erwartete Format für diesen Algorithmus. |
| 401 | unauthorized | Der Schlüssel fehlt, ist fehlerhaft oder widerrufen. Prüfe den Authorization-Header. |
| 402 | insufficient_credits | Das Guthaben liegt unter dem Preis des Aufrufs. Aufladen. Es wurde nichts berechnet. |
| 403 | account_suspended | Das Konto ist gesperrt. Wende dich an den Support. |
| 404 | unknown_tool | Kein Endpunkt mit diesem Schlüssel. Prüfe die genaue Schreibweise in der Referenz. |
| 502 | upstream_unreachable | Der Ziel-Host hat nicht geantwortet. Berechnet - der Versuch wurde in deinem Auftrag unternommen. |
| 502 | upstream_timeout | Das Ziel hat zu lange gebraucht. Erstattet. |
| 502 | internal_error | Ein Fehler auf unserer Seite. Erstattet. Wiederhole den Aufruf; bleibt der Fehler, kontaktiere den Support. |
| 503 | tool_disabled | Dieser Endpunkt ist vorübergehend abgeschaltet. Nicht berechnet. |
Sicher wiederholen
- Wiederhole
502und503mit exponentiellem Backoff - sie sind vorübergehend, und die erstatteten kosten nichts. - Wiederhole
400,401oder403nie, ohne die Anfrage zu ändern - das Ergebnis wäre identisch. - Behandle
402als Stopp, nicht als Wiederholung. Schleifen darauf helfen nicht, bis sich das Guthaben ändert. - Jeder Endpunkt ist nur lesend oder ohne Nebenwirkungen - eine Wiederholung kann also nie bereits bezahlte Arbeit doppelt auslösen.
Bereit zum Loslegen?
Sieh dir alle Endpunkte mit Preisen an oder erstelle einen Schlüssel und mach deinen ersten Aufruf.