Початок роботи

Помилки

Помилки використовують стандартні HTTP-коди статусу та єдине тіло JSON.

404 Not Found

{
  "error": {
    "code": "not_found",
    "message": "No data found for this request. You were not charged.",
    "request_id": "req_k3J9xQ2mT0aB"
  }
}

Завжди записуйте request_id. Він також є в заголовку x-request-id і дає змогу підтримці знайти саме ваш запит.

Статус	Код	Значення	Тарифікується
400	missing_parameter / invalid_parameter / invalid_request	Параметр відсутній або має неправильний формат, наприклад VIN, що не містить 17 допустимих символів.	Ні
401	missing_api_key / invalid_api_key	Ключ не надіслано, або він неправильний чи відкликаний.	Ні
402	insufficient_credits	Балансу кредитів не вистачає для цього запиту.	Ні
403	account_suspended	Акаунт призупинено. Зверніться до підтримки.	Ні
404	not_found / endpoint_not_found	Для цього пошуку даних немає, або маршруту не існує.	Ні
429	rate_limited	Забагато запитів. Дотримуйтеся заголовка retry-after.	Ні
502	upstream_error / upstream_unreachable	Наш постачальник даних повернув помилку. Можна повторити.	Ні
503	maintenance	Планові технічні роботи. Повторіть після часу з заголовка retry-after.	Ні
504	upstream_timeout	Наш постачальник даних відповідав надто довго. Можна повторити.	Ні

Обробка збоїв

Вважайте 4xx проблемою із запитом. Не повторюйте його без змін, окрім 429.
Повторюйте 502, 503 і 504 з експоненційною затримкою. За невдалі спроби плата не стягується.
Встановіть тайм-аут клієнта щонайменше 30 секунд: деякі пошуки залежать від повільніших зовнішніх джерел.