Erste Schritte

Fehler

Behandle Fehler nach HTTP-Status und wiederhole fehlgeschlagene Anfragen nie blind. Sende immer Accept: application/json.

StatusWas tun

400Ungültiger Parameter oder Seitengrößenlimit überschritten. Korrigiere die Anfrage; sende sie nicht unverändert erneut.

401 / 403Key fehlt, ist ungültig, abgelaufen oder inaktiv, oder der Zugriff auf die Quelle wurde verweigert. Prüfe Antwort und Abo; nicht unverändert wiederholen.

404Fahrzeug oder Los nicht gefunden. Zeig ein leeres Ergebnis; erfinde keinen Preis.

429Anfragelimit erreicht. Beachte Retry-After, falls vorhanden; nutze begrenztes Backoff und berücksichtige das Kontingent deines Tarifs.

5xx / timeoutWiederhole nur sichere Lesezugriffe, mit begrenzter Anzahl an Versuchen. Behalte den letzten erfolgreichen Checkpoint und logge weder Keys noch vollständige Antworten.

Fehler bei der Authentifizierung

403{ "error": "please add auth key in x-api-key header" }
403{ "error": "wrong api key" }
403{ "error": "your api subscription has expired" }
403{ "error": "your api subscription is not active" }

Antwort sicher lesen

Prüfungen der Anwendung liefern normalerweise ein Objekt mit error; Fehler von Framework und Gateway nutzen message.
Ein Gateway, Proxy oder Webserver kann HTML, reinen Text oder einen leeren Body liefern, auch wenn JSON angefragt wurde.
Wiederhole nur sichere GET-Anfragen, mit begrenztem Budget und wachsenden Pausen. Behalte deinen letzten erfolgreichen Checkpoint.