---
title: Коды ошибок
description: HTTP-статусы и форматы ошибок Levam OEM API — авторизация, баланс, внутренние ошибки.
---

# Коды ошибок

## Формат

API возвращает ошибки двумя способами:

1. **HTTP-статус + JSON с полем `error`** — ошибки авторизации и системные ошибки.
2. **Поле `error` внутри ответа 200** — прикладные ошибки метода (например, VIN не найден). Пустая строка в `error` означает успех.

## HTTP-статусы

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

## Тарификация ошибочных запросов

Запросы, завершившиеся ошибкой (любой статус кроме 200), **не тарифицируются** — юниты списываются только за успешные ответы. Подробнее — в разделе [Тарификация и биллинг](/docs/ru/billing).