УкраїнськаПочаток роботи
Помилки
Обробляйте помилки за 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-запити, з обмеженим бюджетом спроб і зростаючими затримками. Зберігайте свою останню успішну контрольну точку.