Начало работы

Ошибки

Обрабатывайте ошибки по HTTP-статусу и не повторяйте вслепую каждый неудачный запрос. Всегда отправляйте Accept: application/json.

СтатусЧто делать

400Неверный параметр или размер страницы. Исправьте запрос; не повторяйте без изменений.

401 / 403Ключ отсутствует, неверен, истёк, неактивен либо источник недоступен. Проверьте ответ и подписку; не повторяйте без изменений.

404Автомобиль или лот не найден. Покажите отсутствие результата, не подставляйте цену.

429Лимит запросов. Соблюдайте Retry-After, если он есть; ограничьте повторы и учитывайте лимит пакета.

5xx / timeoutПовторяйте только безопасные чтения с ограниченным числом попыток. Сохраните последнюю успешную отметку; не логируйте ключи и полные ответы.

Ошибки авторизации

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" }

Безопасное чтение ответа

Проверки приложения обычно возвращают объект с error; сбои фреймворка и шлюза используют message.
Шлюз, прокси или веб-сервер могут вернуть HTML, обычный текст или пустое тело, даже если запрошен JSON.
Повторяйте только безопасные GET-запросы, с ограниченным бюджетом и растущими задержками. Сохраняйте последнюю успешную контрольную точку.