Главная → Документация → Сервисная история

Сервисная история автомобиля

История сервисного обслуживания автомобиля по VIN: даты визитов, города, виды работ и описание выполненных операций. Помогает понять, как обслуживался автомобиль, и сопоставить записи с заявленным пробегом.

Хост api.avtovincod.ru Метод GET Формат JSON Авторизация Bearer Ответ до 30 сек

Аутентификация

Единый API-токен для всех API выдаётся сразу после регистрации в личном кабинете. Передавайте его в заголовке:

Authorization: Bearer ВАШ_ТОКЕН

Эндпоинт

GET https://api.avtovincod.ru/service?vin=XTA210990Y2696785
Authorization: Bearer ВАШ_ТОКЕН

Параметр	Описание
vin	VIN, строго 17 символов (латиница без I, O, Q). Кириллические двойники нормализуются автоматически.
force_refresh=1	Необязательный. Игнорировать кэш.

Пример успешного ответа

{
  "success": 1,
  "query": { "vin": "SALFA2BB0AH206559" },
  "found": 2,
  "records": [
    {
      "date": "2013-06-16",
      "city": null,
      "type": "Гарантийный ремонт на СТО",
      "description": null,
      "mileage": 99215,
      "source": "archive"
    },
    {
      "date": "2018-06-27",
      "city": null,
      "type": "Заезд на СТО",
      "description": "Услуги: углы установки колес — проверка и регулировка. Рекомендации: выполнить калибровку датчика положения рулевого колеса.",
      "mileage": 202390,
      "source": "archive"
    }
  ]
}

Ответ объединяет данные источника с накопленным архивом: записи из архива помечены source: "archive" и могут содержать mileage — пробег на момент обслуживания (км). Пустой список records при success: 1 означает лишь отсутствие записей в доступных источниках.

Коды ошибок

HTTP · code	Что означает
400 · BAD_VIN	Неверный формат VIN (нужно строго 17 символов).
400 · INPUT_REQUIRED	VIN не указан.
403 · NOT_ALLOWED / API_DISABLED	API не подключён для токена или временно отключён. Запросите доступ в кабинете.
401 · NO_TOKEN / TOKEN_INVALID	Токен не передан, неверен или деактивирован. Возьмите актуальный в кабинете.
402 · INSUFFICIENT_BALANCE	Недостаточно средств. Пополните баланс в кабинете (раздел «Платежи»).
403 · IP_NOT_ALLOWED	IP не входит в ваш белый список (если он настроен).
429 · RATE_LIMIT / RATE_LIMIT_IP	Превышена частота запросов в минуту. Повторите через минуту.
200 · PROVIDER_FAIL (success: 0)	Источник не смог выполнить проверку. Запрос не тарифицирован, повторите позже.
503 · SERVICE_UNAVAILABLE	Источник временно недоступен. Повторите позже, запрос не тарифицирован.

Пример на cURL

curl -s --max-time 60 "https://api.avtovincod.ru/service?vin=XTA210990Y2696785" \
  -H "Authorization: Bearer ВАШ_ТОКЕН"

Тарификация

Списание происходит, когда проверка выполнена (success: 1), даже если записей об обслуживании нет. Ошибки, недоступность источника и повторы из кэша не тарифицируются. Актуальная цена, баланс и статистика запросов с телами ответов доступны в личном кабинете.

Попробуйте прямо сейчас. Регистрация за минуту, токен сразу, пополнение картой от 100 ₽. Проверить можно и без кода: в кабинете есть консоль проверки.

Создать аккаунт