Limits und Fehler
Jede Antwort trägt X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset — Sie sehen ein Limit kommen, statt es zu entdecken.
Die Kontingente
Ein kostenloser Key sind 100 Anfragen pro Tag, Reset um Mitternacht UTC; am nächsten Tag geht es unverändert weiter, es gibt nichts zu verlängern. Pro sind 5.000 pro Tag, Business 25.000, Enterprise ist bei fairer Nutzung unbegrenzt.
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97
X-RateLimit-Reset: 1761264000| status | meaning |
|---|---|
| 200 | A normal answer. Check X-RateLimit-Remaining while you are here. |
| 400 | A parameter could not be parsed — a non-numeric yearFrom, for instance. |
| 401 | Missing or unknown key. Send it as the x-api-key header. |
| 404 SOLD_OR_REMOVED | From /car: the vehicle is gone from Encar. Drop it on your side. |
| 429 | Daily allowance spent. X-RateLimit-Remaining tells you before it happens. |
| 503 | The Korean source did not answer in time. Retry once, then fall back. |
Ein verkauftes Auto behandeln
Das ist der Fehler, für den sich Code lohnt. GET /car prüft die Verfügbarkeit live, ein Fahrzeug, das Encar verlassen hat, antwortet also mit 404 und dem Code SOLD_OR_REMOVED. Behandeln Sie das als Signal zum Depublizieren, nicht als Fehlschlag zum Wiederholen — morgen kommt dieselbe 404.
HTTP/1.1 404 Not Found
{ "error": "SOLD_OR_REMOVED", "id": "38421907" }Ihren API-Key holen
Kostenlos · 100 Anfragen pro Tag
Weiterlesen
Beliebig kombinierbar in einem Aufruf. Die Antwort enthält total, page, count und results[], Sie können also ohne zweite Anfrage über total paginieren.
Die Daten stammen aus einer koreanischen Quelle, deshalb werden vier dieser Felder standardmäßig falsch gelesen. Jeder dieser Fehler bleibt stumm — Ihre Seite rendert, sie ist nur falsch.
Eine Zahl im Monat, keine Abrechnung pro Aufruf, die Sie prognostizieren müssten, und keine Einrichtungsgebühr. Die kostenlose Stufe ist eine echte Stufe, keine ablaufende Testphase.