Лимиты и ошибки
В каждом ответе есть X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset, поэтому лимит видно заранее, а не по факту.
Квоты
Бесплатный ключ — 100 запросов в сутки со сбросом в полночь UTC; на следующий день всё продолжается без изменений, продлевать нечего. Pro — 5 000 в сутки, Business — 25 000, Enterprise — без ограничения при честном использовании.
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. |
Что делать с проданной машиной
Это та ошибка, ради которой стоит писать код. GET /car проверяет наличие вживую, поэтому автомобиль, покинувший Encar, отвечает 404 с кодом SOLD_OR_REMOVED. Считайте это сигналом снять объявление у себя, а не сбоем для повтора — завтра придёт та же 404.
HTTP/1.1 404 Not Found
{ "error": "SOLD_OR_REMOVED", "id": "38421907" }Получите свой API-ключ
Бесплатно · 100 запросов в сутки
Читайте также
Их можно сочетать в одном вызове. В ответе есть total, page, count и results[], поэтому листать можно по total без второго запроса.
Данные приходят из корейского источника, поэтому четыре поля по умолчанию читаются неверно. Каждая такая ошибка тихая — страница отрисуется, просто неправильно.
Одна сумма в месяц, никакой поштучной тарификации, которую пришлось бы прогнозировать, и никакой платы за подключение. Бесплатный тариф — настоящий тариф, а не истекающий пробный период.