Първи стъпки

Грешки

Обработвайте грешките по 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 заявки, с ограничен брой опити и нарастващи паузи. Пазете последната си успешна контролна точка.