Limity i błędy
Każda odpowiedź niesie X-RateLimit-Limit, X-RateLimit-Remaining i X-RateLimit-Reset, więc limit widać nadchodzący, a nie odkrywa się go po fakcie.
Przydziały
Darmowy klucz to 100 zapytań dziennie z resetem o północy UTC; następnego dnia wszystko idzie dalej bez zmian, nie ma czego odnawiać. Pro to 5000 dziennie, Business 25 000, a Enterprise jest bez limitu przy uczciwym użyciu.
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. |
Obsługa sprzedanego auta
To błąd, dla którego warto napisać kod. GET /car sprawdza dostępność na żywo, więc pojazd, który opuścił Encar, odpowiada kodem 404 i SOLD_OR_REMOVED. Traktuj to jako sygnał do zdjęcia ogłoszenia u siebie, a nie jako awarię do ponowienia — jutro wróci ten sam 404.
HTTP/1.1 404 Not Found
{ "error": "SOLD_OR_REMOVED", "id": "38421907" }Odbierz swój klucz API
Za darmo · 100 zapytań dziennie
Czytaj dalej
Dowolnie je łącz w jednym wywołaniu. Odpowiedź niesie total, page, count i results[], więc możesz stronicować po total bez drugiego zapytania.
Dane pochodzą z koreańskiego źródła, więc cztery z tych pól są domyślnie czytane błędnie. Każdy taki błąd jest cichy — strona się wyrenderuje, tyle że niepoprawnie.
Jedna kwota miesięcznie, żadnego rozliczania za wywołanie do prognozowania i żadnej opłaty wdrożeniowej. Plan darmowy jest prawdziwym planem, a nie wygasającym triałem.