Главная → Документация → Проверка каршеринга

Проверка использования в каршеринге

Проверка, использовался ли автомобиль в каршеринге: факт эксплуатации в каршеринговом парке и название каршеринговой компании. Поиск по государственному номеру или VIN. Каршеринговые автомобили эксплуатируются интенсивно — проверка помогает оценить реальный износ перед покупкой.

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

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

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

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

Эндпоинт

GET https://api.avtovincod.ru/sharing?plate=А123ВС777
Authorization: Bearer ВАШ_ТОКЕН

Параметр	Описание
plate	Госномер. Русские буквы АВЕКМНОРСТУХ и цифры, от 6 до 9 символов. Латиница нормализуется автоматически, пробелы и дефисы игнорируются. Синоним параметра: regNumber. Основной параметр.
vin	VIN, строго 17 символов. Без plate — проверка только по архивной базе (списание лишь при находке). Вместе с plate — дополнительный идентификатор: при находке пара госномер+VIN сохраняется.
force_refresh=1	Необязательный. Игнорировать кэш.

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

{
  "success": 1,
  "query": { "regNumber": "К131КХ799" },
  "isCarsharing": true,
  "company": "Делимобиль",
  "checkedBy": "registry"
}

— проверка по VIN (по накопленной базе):

{
  "success": 1,
  "query": { "vin": "XW8AC2NH5JK137015" },
  "isCarsharing": true,
  "company": null,
  "checkedBy": "database",
  "dataNote": "Проверка по накопленной базе каршеринга (архив). Полная проверка по реестру доступна по госномеру."
}

Поле checkedBy показывает режим: registry — полная проверка по реестру (по госномеру, возвращается название компании в company); database — проверка по накопленной архивной базе (по VIN, без обращения к реестру). Пару plate+vin можно передать вместе: поиск идёт по номеру, найденная пара госномер+VIN сохраняется в базе. isCarsharing: false при success: 1 — проверка выполнена, записей нет.

Коды ошибок

HTTP · code	Что означает
400 · BAD_VIN / BAD_PLATE	Неверный формат VIN или госномера.
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/sharing?plate=А123ВС777" \
  -H "Authorization: Bearer ВАШ_ТОКЕН"

Тарификация

По госномеру: списание при выполненной проверке (success: 1), даже если каршеринг не найден. По VIN (по базе): списание только если запись найдена (isCarsharing: true); «в базе нет» — бесплатно. Ошибки, недоступность источника и повторы из кэша не тарифицируются. Актуальная цена, баланс и статистика запросов с телами ответов доступны в личном кабинете.

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

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