Коды ошибок
Формат
API возвращает ошибки двумя способами:
- HTTP-статус + JSON с полем
error— ошибки авторизации и системные ошибки. - Поле
errorвнутри ответа 200 — прикладные ошибки метода (например, VIN не найден). Пустая строка вerrorозначает успех.
HTTP-статусы
| Статус | Тело | Причина | Что делать |
|---|---|---|---|
| 200 | {"...": "...", "error": ""} | Успех | — |
| 200 | {"...": "...", "error": "текст"} | Прикладная ошибка метода (данные не найдены и т.п.) | Проверить параметры запроса |
| 401 | {"error": "invalid api key"} | Ключ не передан, не найден или заблокирован | Проверить api_key в кабинете |
| 403 | {"error": "Client disabled. not enough money"} | Закончились юниты или истёк срок пакета | Пополнить баланс в кабинете |
| 404 | {"error": "error"} | Несуществующий метод / путь | Проверить URL метода |
| 5xx | — | Внутренняя ошибка сервиса | Повторить позже; если повторяется — написать в поддержку |
Тарификация ошибочных запросов
Запросы, завершившиеся ошибкой (любой статус кроме 200), не тарифицируются — юниты списываются только за успешные ответы. Подробнее — в разделе Тарификация и биллинг.