Fehler der API und was sie bedeuten
Jeder Fehler hat einen festen Code für Ihre Software und einen deutschen Satz für Ihr Protokoll. Abfragen mit Fehler zählen nie zum Kontingent.
{
"error": {
"code": "unknown_make",
"message": "Die Marke «Ferari» kennen wir nicht.",
"suggestions": [
"Ferrari"
]
}
}{
"error": {
"code": "quota_exceeded",
"message": "Das Kontingent von 2000 Bewertungen ist für diesen Monat aufgebraucht.",
"resetsAt": "2026-10-31T23:00:00.000Z"
}
}Wie sieht ein Fehler aus?
Jeder Fehler kommt als JSON mit dem Objekt error. error.code ist ein fester englischer Code, auf den Ihre Software reagiert. error.message ist ein deutscher Satz für Ihr Protokoll. Manche Fehler bringen mehr mit: error.field, error.suggestions oder error.resetsAt. Ein Fehler zählt nie zum Kontingent.
Welche Fehler gibt es?
400 heisst, ein Feld fehlt oder ist falsch. 401 und 403 betreffen den Schlüssel. 404 heisst, Marke oder Modell sind nicht im Katalog. 422 heisst, es gibt keinen sicheren Wert. 429 heisst, zu schnell oder Kontingent aufgebraucht. 503 heisst, die API ist kurz pausiert.
| Feld | Typ | Bedeutung |
|---|---|---|
400 | invalid_request | Ein Feld fehlt oder ist falsch; error.field nennt es. |
401 | unauthorized | Schlüssel fehlt, ist falsch oder gesperrt, oder der Zugang ist pausiert. |
403 | forbidden | Abfrage von einer Server-Adresse, die für den Schlüssel nicht freigegeben ist. |
404 | unknown_make · unknown_model | Nicht im Katalog; error.suggestions nennt ähnliche Namen. |
422 | too_few_comparables · too_old | Kein sicherer Wert: zu wenige Vergleiche oder älter als 25 Jahre. |
429 | rate_limited · quota_exceeded | Zu schnell, oder das Kontingent ist aufgebraucht; Retry-After oder error.resetsAt sagt, wann es weitergeht. |
503 | unavailable | Die API ist kurz pausiert. Nach einigen Minuten erneut versuchen. |
Was tun bei Fehler 429?
Prüfen Sie error.code. Bei rate_limited haben Sie mehr als 60 Abfragen in einer Minute geschickt; warten Sie die Sekunden aus dem Header Retry-After ab. Bei quota_exceeded ist das Kontingent des Monats verbraucht; es geht am Datum in error.resetsAt weiter, oder sofort mit einem grösseren Paket. Fehlt error.resetsAt, fehlt ein Paket oder seine Zahlung ist offen; error.message nennt, was hilft.
Pakete und Grenzen: Grenzen und Pakete.
Wann soll meine Software es erneut versuchen?
Nur bei 429 mit rate_limited und bei 503, und erst nach der Zeit im Header Retry-After. Alle anderen Fehler kommen bei derselben Anfrage wieder: Korrigieren Sie bei 400 das Feld, bei 404 den Namen, und zeigen Sie bei 422 statt eines Werts einen Hinweis.
Nicht gefunden, was Sie suchen?Schreiben Sie an info@prisradar.ch oder über das Kontaktformular.