🔌 API vagvin.ru

Подключите проверку VIN автомобилей к вашему сервису через наш API

Автоматизируйте получение отчётов по истории обслуживания, комплектации и проверкам авто

🎯 Для чего подходит наш API?

🌐 Интеграция на сайт

Добавьте проверку VIN на ваш автомобильный сайт, площадку объявлений или портал автосалона. Клиенты получают отчёты прямо на вашем сайте.

🤖 Создание Telegram-бота

Запустите своего бота для проверки авто в Telegram. Мы обрабатываем запросы — вы получаете готовые отчёты для ваших клиентов.

📱 Мобильное приложение

Интегрируйте API в ваше iOS/Android приложение для проверки автомобилей перед покупкой.

🏢 CRM-системы автосалонов

Автоматизируйте проверку trade-in автомобилей. API интегрируется с любой CRM.

📊 Агрегаторы отчётов

Станьте партнёром и предоставляйте отчёты vagvin.ru под своим брендом с собственной наценкой.

🔄 Автоматизация процессов

Интеграция с системами автоматической оценки авто, страховыми сервисами, лизинговыми компаниями.

📡 Эндпоинт API

POST https://vagvin.ru/api/process

Content-Type: application/json

📋 Параметры запроса

Обязательные параметры

Параметр Тип Описание
api_key * string Ваш уникальный API-ключ
commands * string Команда проверки (см. список команд ниже)
vin * string VIN номер автомобиля (17 символов)
marka * string Марка автомобиля (BMW, Mercedes, VAG и т.д.)
adress_post * string URL вашего webhook для получения результата

Опциональные параметры

Параметр Тип Описание
lang (опц.) string Язык отчёта: RU, EN, PL, RO, FR, DE, ES (по умолчанию EN)
uid (опц.) string Уникальный идентификатор заказа в вашей системе
order_uiid (опц.) string UUID заказа для отслеживания

⚡ Доступные команды и цены

📌 Актуальный список команд и цен всегда доступен в JSON:
📄 vagvin.ru/static/brands.json

⚡ Автоматические отчёты

check_etka_full_api_logo
VAG комплектация + logo
299₽
check_avtoteka_api
Автотека РФ
129₽
check_CARFAX
CARFAX USA/Canada
299₽
check_autocheck
AutoCheck USA/Canada
299₽
check_auktion_lot_api
Аукционные лоты USA/Korea
49₽

👨‍💻 Запросы через дилера

check_data_bmw_full
BMW AIR полный отчёт
499₽
check_data_mercedes_eva
Mercedes EVA история
599₽
check_elsa_pro_full
VAG ELSA история
499₽
check_data_multibr_zapros
История мультибренд
499₽

🌍 Международные отчёты

check_CarVertical
CarVertical Европа
1299₽
check_autodna
AutoDNA Европа
1499₽
check_koreya_full
Корея полный отчёт
799₽
check_china_strah_to
Китай страховые + ТО
1499₽

🔧 Специальные запросы

check_pin_vag
PIN код магнитолы VAG
999₽
check_data_bmw_fsc
FSC коды BMW
999₽
check_nomer_dws
Номер ДВС из базы ОД
499₽

💻 Примеры запросов

cURL

curl -X POST https://vagvin.ru/api/process \ -H "Content-Type: application/json" \ -d '{ "api_key": "ваш_api_ключ", "commands": "check_CARFAX", "vin": "JTEBR3FJ30K226257", "marka": "Toyota", "lang": "EN", "adress_post": "https://yourserver.com/webhook/result", "order_uiid": "order_12345" }'

Python

import requests url = "https://vagvin.ru/api/process" payload = { "api_key": "ваш_api_ключ", "commands": "check_CARFAX", "vin": "JTEBR3FJ30K226257", "marka": "Toyota", "lang": "EN", "adress_post": "https://yourserver.com/webhook/result", "order_uiid": "order_12345" } response = requests.post(url, json=payload) print(response.json())

JavaScript (Node.js)

const axios = require('axios'); const data = { api_key: "ваш_api_ключ", commands: "check_CARFAX", vin: "JTEBR3FJ30K226257", marka: "Toyota", lang: "EN", adress_post: "https://yourserver.com/webhook/result", order_uiid: "order_12345" }; axios.post('https://vagvin.ru/api/process', data) .then(response => console.log(response.data)) .catch(error => console.error(error));

📤 Ответ API

Успешный ответ (200 OK)

{
  "status": "success",
  "user_id": 232,
  "balance": 1500.50,
  "overdraft": 0,
  "vin": "JTEBR3FJ30K226257",
  "commands": "check_CARFAX",
  "cost": 299
}
ПолеОписание
statusСтатус обработки ("success")
user_idВаш внутренний ID в системе
balanceОстаток баланса после списания
overdraftДоступный овердрафт
vinОбработанный VIN
costСписанная сумма

⚠️ Возможные ошибки

Код Описание Пример ответа
400 Неверный формат запроса / отсутствуют обязательные поля {"error": "Отсутствуют обязательные поля: api_key, vin"}
402 Недостаточно средств на балансе {"error": "Баланс + овердрафт недостаточны, не хватает 150 руб."}
403 Неверный API-ключ {"error": "Неверный API-ключ"}
404 Команда не найдена / не поддерживается для марки {"error": "Команда не найдена"}
429 Слишком частые запросы (для /api/balance: не более 1 запроса в 30 сек) {"error": "Слишком частые запросы", "retryAfterSeconds": 25}
500 Ошибка сервера обработки {"error": "Internal server error"}

💰 Проверка баланса

Получить текущий баланс можно отдельным запросом. Не более 1 запроса в 30 секунд на один API-ключ.

POST https://vagvin.ru/api/balance

Content-Type: application/json

Параметры

Параметр Тип Описание
api_key * string Ваш уникальный API-ключ

Пример запроса

curl -X POST https://vagvin.ru/api/balance \
  -H "Content-Type: application/json" \
  -d '{"api_key": "ваш_api_ключ"}'

Успешный ответ (200 OK)

{
  "status": "success",
  "user_id": 2705,
  "balance": 1500.50,
  "overdraft": 0,
  "available": 1500.50
}

Поля ответа

ПолеОписание
balanceТекущий баланс в рублях
overdraftДоступный овердрафт
availableДоступно к списанию (balance + overdraft)
Важно: при превышении лимита запросов вернётся ошибка 429 с заголовком Retry-After. Повторите запрос через указанное количество секунд.

🚗 Отчёт Автокод РФ (99 руб.)

Отчёт по автомобилям РФ по VIN или гос. номеру. Стоимость — 99 руб., списывается с баланса. Ответ приходит сразу — готовая ссылка на отчёт.

POST https://vagvin.ru/api/avtocod

Content-Type: application/json

Параметры

Параметр Тип Описание
api_key * string Ваш уникальный API-ключ
vin * string VIN (17 символов) или гос. номер РФ (например А123ВС77) или номер шасси/кузова. Тип определяется автоматически.
query_type (опц.) string Явное указание типа: GRZ (гос.номер), VIN, BODY, CHASSIS. Если не указано — определяется автоматически.
uid (опц.) string Идентификатор заказа в вашей системе
order_uiid (опц.) string UUID заказа для отслеживания

Пример запроса

curl -X POST https://vagvin.ru/api/avtocod \
  -H "Content-Type: application/json" \
  -d '{"api_key": "ваш_api_ключ", "vin": "А123ВС777"}'

Успешный ответ (200 OK)

{
  "status": "success",
  "user_id": 2705,
  "query": "А123ВС777",
  "query_type": "GRZ",
  "report_uuid": "f9f6ad5e-88bd-454b-9939-0412a84694f3",
  "report_link": "https://profi.avtocod.ru/report/guest/f9f6ad5e-...",
  "cost": 99,
  "balance": 1401.50
}

Поля ответа

ПолеОписание
report_linkГотовая ссылка на отчёт (открывается без авторизации)
query_typeТип запроса: GRZ / VIN / BODY / CHASSIS
costСписанная сумма (99 руб.)
balanceОстаток баланса после списания
Примечания:
  • Работает только для транспортных средств, зарегистрированных в РФ
  • Отчёт формируется сразу, webhook не требуется
  • При ошибке формирования отчёта деньги не списываются

💳 Пополнение баланса через СБП

Создаёт платёж пополнения через СБП и возвращает прямую ссылку на оплату (qr.nspk.ru). Ссылку можно открыть в браузере, отсканировать камерой банка или отправить клиенту. Баланс зачисляется автоматически после оплаты.

POST https://vagvin.ru/api/topup

Content-Type: application/json

Параметры

Параметр Тип Описание
api_key * string Ваш уникальный API-ключ
amount * number Сумма пополнения в рублях (минимум 1). На баланс зачисляется сумма 1:1 — без наценки

Пример запроса

curl -X POST https://vagvin.ru/api/topup \
  -H "Content-Type: application/json" \
  -d '{"api_key": "ваш_api_ключ", "amount": 500}'

Успешный ответ (200 OK)

{
  "status": "success",
  "user_id": 2705,
  "payment_id": "323fa6b4-000f-5001-8000-1ecfd884de29",
  "amount": 500,
  "amount_charged": 500.00,
  "sbp_url": "https://qr.nspk.ru/BD201042SJ4L8H8G91QB2Q91VVK9O0E7",
  "message": "Оплатите по ссылке из приложения банка. Баланс зачислится автоматически."
}

Поля ответа

ПолеОписание
sbp_urlПрямая ссылка СБП (qr.nspk.ru) — откройте или отсканируйте в приложении банка
amountСумма, которая будет зачислена на баланс
amount_chargedСумма к оплате (равна amount — без наценки для API-клиентов)
payment_idИдентификатор платежа ЮKassa
Важно: ссылка действует ограниченное время (~10 минут). После оплаты баланс пополняется автоматически — проверять можно через /api/balance. Неоплаченная ссылка просто сгорает, средства не списываются.

🔔 Webhook (получение результата)

После обработки заказа результат отправляется на указанный adress_post

Формат отправки: результат приходит одним из трёх типов webhook. Тип определяется типом результата, а не именем команды.
ТипContent-TypeКогдаРезультат в
A. Файлmultipart/form-dataОтчёт-документ PDF / JPG / PNGполе File
B. Текст / ссылкаapplication/jsonСсылка на внешний отчёт, текстовый результат либо отказ «данных нет»additional_text (при отказе также otwet_zaprosa_api)
C. Автотекаapplication/jsonТолько команда check_avtoteka_apiweb_link, pdf_link, report_id

Общий блок полей — есть в каждом webhook

ПолеОписание
vin и vin_otvVIN — оба поля всегда заполнены одинаковым значением
tip_site и commandsКоманда заказа (одинаковые значения)
markaМарка автомобиля из заказа
order_uiidВаш order_uiid из запроса (пусто, если не передавали)
uidВаш uid из запроса (пусто, если не передавали)
statusok / success / error
РезультатstatusТипГде данные
✅ Отчёт-документ полученokA (multipart)поле File
🔗 Отчёт-ссылка или текстokB (JSON)additional_text
🔗 Автотека: ссылкиsuccessC (JSON)web_link, pdf_link, report_id
⚠️ Нет данных / отказ оператораerrorB (JSON)otwet_zaprosa_api — причина текстом
❌ Ошибка обработкиerrorB или C (JSON)otwet_zaprosa_api или error
🔁 Повторная отправка (retry): до 3 попыток, паузы 5 и 10 секунд — для всех типов webhook. Повтор только при сетевой ошибке или таймауте. Если ваш сервер ответил любым HTTP-кодом (в т.ч. 4xx/5xx) — доставка считается завершённой, повторов нет. Таймаут ответа вашего сервера: 30 секунд.

Примеры webhook

Поле File — ровно одно на вызов: несколько файлов = несколько вызовов. Типы файлов: application/pdf, image/jpeg, image/png, до ~20 МБ на файл.

A. Файл (multipart/form-data):
POST https://your-server.com/webhook/result

File:       report.pdf (application/pdf)
vin         = JTEBR3FJ30K226257
vin_otv     = JTEBR3FJ30K226257
tip_site    = check_data_multibr_zapros
commands    = check_data_multibr_zapros
marka       = Toyota
order_uiid  = order_12345
uid         = your-uid-1
status      = ok
B. Ссылка / текст (application/json):
{
  "vin": "JTEBR3FJ30K226257",
  "vin_otv": "JTEBR3FJ30K226257",
  "tip_site": "check_CarVertical",
  "commands": "check_CarVertical",
  "marka": "Toyota",
  "order_uiid": "order_12345",
  "uid": "your-uid-1",
  "status": "ok",
  "additional_text": "https://external-report-link/..."
}
B. Отказ: данных нет (application/json):
{
  "vin": "JTEBR3FJ30K226257",
  "vin_otv": "JTEBR3FJ30K226257",
  "tip_site": "check_data_multibr_zapros",
  "commands": "check_data_multibr_zapros",
  "marka": "Toyota",
  "order_uiid": "order_12345",
  "uid": "your-uid-1",
  "status": "error",
  "otwet_zaprosa_api": "Данный Vin определен верно, но в базах дилера на него истории нет."
}
C. Автотека (application/json):
{
  "status": "success",
  "order_uiid": "bf9fd5bd-5a80-4548-a54a-44a6a0c0ba76",
  "uid": "your-uid-1",
  "vin": "WBA11ES04MWX27377",
  "vin_otv": "WBA11ES04MWX27377",
  "tip_site": "check_avtoteka_api",
  "commands": "check_avtoteka_api",
  "marka": "BMW",
  "report_id": 221063841,
  "web_link": "https://autoteka.ru/report/web/uuid/...",
  "pdf_link": "https://api.autoteka.ru/pdf-report/uuid/...?vin=WBA11ES04MWX27377"
}
⚠️ Важно:
  • Ваш сервер должен принимать POST-запросы с файлами (multipart) и с JSON
  • Отвечайте HTTP 200 — тело ответа мы не проверяем
  • Рекомендуется использовать HTTPS для adress_post
  • Продукт определяется парой commands + marka — точный список строк: brands.json
  • Webhook отправляются с IP 38.244.205.223 — при необходимости внесите его в whitelist

🧪 Тестовые запросы для проверки интеграции (бесплатно)

Каждая пара VIN + команда ниже обрабатывается БЕСПЛАТНО — баланс не списывается. Это готовые VIN с данными в базах, по одному на каждый тип проверки. Важно: в колонке «Язык (lang)» указан язык отчёта по данному VIN — заказывайте тест с этим значением поля lang.

⚡ Автоматические отчёты

КомандаТестовый VINМарка (marka)Язык (lang)
check_etka_fullWAUZZZF42KA030011AudiRU
check_avtoteka_apiSCBCN13S2TC024887 / XTA219040P0906805—RU
check_etka_full_api_logoWVWZZZ3CZGE005256VWRU
fgst_txt_v2WAUZZZF42KA030011Audi— (txt-файл)
check_CARFAXYV1CY59H841086079VolvoEN
check_autocheck1C4HJXFN3JW242680JeepEN
check_vinhistory1GYS4BKLXMR473531Cadillac— (EN)
check_auktion_lot_api19UDE4H60PA011041Acura— (EN)
carinfo_lite_rbVF1RFE00155388304RenaultRU
check_avbyWAUZZZ4G4GN038785AudiRU
detal_obsl / detal_obsl_komplWVGZZZ5NZNW030990VWRU

👨‍💻 Запросы через дилера

КомандаТестовый VINМарка (marka)Язык (lang)
check_data_multibr_zaprosJTEBR3FJ30K226257ToyotaRU
check_data_multibr_zaprosJTNBE40K903132834ToyotaEN
check_data_multibr_zapros (Mercedes)WDC2539151V206030MercedesRU
check_data_mercedes_evaW1NFB0KB8SB402223MercedesEN
check_mers_dpW1K2220211A585503MercedesEN
check_data_bmw_fullWBA71AC0305U35351BMWEN
check_bmw_data_apiWBA71AC0305U35351BMWEN
check_data_bmw_fscWBACW010109C12525BMW— (FSC-архив)
check_multibr_pr_kod (комплектация)VXKFBYHZTP1083819OpelRU
check_multibr_pr_kod (дата производства)YV1LF0628P1983349VolvoRU
check_nomer_dwsWVGZZZCR8TD026107VWEN
check_elsa_pro_fullWAUZZZ8K1EA124543AudiRU
check_elsa_prkod_fullWAUW2AFC1EN042809AudiEN
check_erwin_fullWAUZZZ8K2EA013385AudiRU
check_cm_aktionW1KLF4HB8RA023273Mercedes— (скрин)
volvo_probegYV1XZBBVFM2414739VolvoEN

🌍 Международные отчёты

КомандаТестовый VINМарка (marka)Язык (lang)
check_CarVerticalWBAUZ35010NE43083BMWEN
check_autodnaWBAUZ35010NE43083BMWRU
check_koreya_fullWBSJF0105JG965648BMWEN
check_china_strahLFV2B2GA2N5624351VWEN
check_china_strah_toLFV2B2F37L7742710VWEN
check_japan_strah_toZC83S-502378ToyotaRU
carinfo_auktion_fullWF0PXXGCHPNR11289FordEN

🇷🇺 Автокод РФ (отдельный эндпоинт)

ЭндпоинтТестовый VINЯзык
POST /api/avtocodJMZKE5W7A00623042RU
POST /api/avtocodWDC2539191F753149RU

Параметры как в обычном запросе Автокода (см. раздел выше): только api_key и vin — отчёт приходит сразу ссылкой report_link.

Пример бесплатного тестового запроса

curl -X POST https://vagvin.ru/api/process \ -H "Content-Type: application/json" \ -d '{"api_key": "ваш_api_ключ", "commands": "check_data_multibr_zapros", "vin": "JTNBE40K903132834", "marka": "Toyota", "lang": "EN", "adress_post": "https://yourserver.com/webhook/result", "order_uiid": "test_001"}'

В ответе "cost": 0 — баланс не изменился.

❓ Частые вопросы API-партнёров (FAQ)

1. Язык отчёта не совпал с заказанным

Язык заказа (lang) всегда передаётся при формировании отчёта и возвращается в webhook тем же значением. Для тестовых VIN заказывайте язык, указанный в колонке «Язык (lang)» таблицы выше. Если нужный язык отсутствует в таблице — уточните доступность у поддержки до заказа.

2. AutoDNA — доступен ли английский

Сейчас AutoDNA официально доступен только на русском (languages: "RU" в brands.json). Английская версия — по согласованию, статистика доступности уточняется.

3. Как выбрать комплектацию (PR-коды) или дату производства

Команда check_multibr_pr_kod существует в двух вариантах каталога: «Комплектация а/м по vin» (PR-коды) и «Запрос даты производства». Тестовые VIN в таблице выше уже разведены по маркам: Opel — комплектация, Volvo — дата производства. Для боевых заказов тип результата определяется маркой из brands.json; уточнить нужный вариант можно у поддержки до заказа.

4. Реальное время доставки ETKA

ETKA (check_etka_full, check_etka_full_api_logo) — автоматический отчёт: при доступности источника 5–15 минут, 24/7. Если источник временно недоступен, заказ автоматически переводится на оператора — в этом случае доставка занимает от 20 минут до нескольких часов (в рабочее время). Если webhook не пришёл в течение 2 часов — напишите в поддержку с вашим order_uiid: проверим статус и доставим отчёт вручную.

5. Как протестировать все типы отчётов без баланса

Используйте таблицу тестовых VIN выше — каждая пара VIN+команда бесплатна. Перед заказом можно бесплатно проверить наличие данных через Pre-check API (CARFAX/Autocheck, Vinhistory, аукционы, Автотека, РБ+ЕС).

6. Webhook не пришёл — что делать

1) Проверьте, что ваш сервер отвечал HTTP 200 и принимал POST (multipart и JSON).
2) Проверьте, что IP 38.244.205.223 не заблокирован вашим firewall.
3) Напишите в поддержку с order_uiid — по нему мы найдём заказ в системе: при успешной обработке отчёт будет доставлен повторно вручную, при неуспешной — средства возвращаются на баланс.

⏱️ Время обработки

Тип отчёта Время
⚡ Автоматические отчёты (CARFAX, Автотека, ETKA) 5-15 минут
⚡ ETKA — если источник недоступен (перевод на оператора) до нескольких часов (в рабочее время)
👨‍💻 Ручные запросы через дилера (BMW, Mercedes, VAG) 20-60 минут (в рабочее время)
📊 Сложные международные отчёты до 2-3 часов

📌 Важные примечания

  • Баланс списывается автоматически при успешной обработке запроса
  • Проверка баланса происходит до обработки — при недостатке вернётся ошибка 402
  • Параметр adress_post обязателен для всех API-клиентов
  • API работает 24/7 с автоматической обработкой очереди
  • Актуальные цены всегда доступны: brands.json
  • Все запросы логируются в систему мониторинга

🔍 Pre-check API — предварительная проверка VIN

Проверьте наличие данных по VIN перед покупкой полного отчёта. Доступно только при положительном балансе (бесплатно, баланс не списывается). Rate limit: не чаще 1 запроса в 1 секунду на эндпоинт.

✅ Нейтральный ответ: Все названия поставщиков скрыты. Вы получаете только данные, без ссылок и упоминаний источников.

Эндпоинты

POST https://vagvin.ru/api/v1/precheck/carfax-autocheck

Проверка наличия записей в базах истории США. Ответ: precheck_usa_history, precheck_usa_auction_data

🔹 Тестовый VIN: 4JGFB4FB8SB491277 — есть данные (15/36 записей, Mercedes-Benz GLE 2025)

POST https://vagvin.ru/api/v1/precheck/vinhistory

Проверка фотоотчёта по авто из США/Канады. Ответ: precheck_photo_report

🔹 Тестовый VIN: KL77LJE22RC119425 — есть данные (10 фото, CHEVROLET Trax 2024)

POST https://vagvin.ru/api/v1/precheck/auction-lots

Проверка наличия данных об аукционных лотах. Ответ: precheck_auction_lots

POST https://vagvin.ru/api/v1/precheck/autoteka

Проверка наличия данных в Автотеке РФ. Ответ: precheck_autoteka

🔹 Тестовый VIN: WBA11ES04MWX27377 — есть данные (BMW SERIE 5 2021)

POST https://vagvin.ru/api/v1/precheck/rb-eu

Проверка данных РБ и аукционов ЕС. Ответ: precheck_rb_data, precheck_eu_auctions

🔹 Тестовый VIN: WVWZZZ3CZKE093181 — есть данные (Volkswagen Passat B8)

Параметры запроса

Параметр Тип Описание
api_key * string Ваш API-ключ (можно передать в заголовке X-API-Key)
vin * string VIN номер автомобиля (17 символов)

Пример запроса

curl -X POST https://vagvin.ru/api/v1/precheck/carfax-autocheck \ -H "Content-Type: application/json" \ -H "X-API-Key: ваш_api_ключ" \ -d '{"vin": "4JGFB4FB8SB491277"}'

Пример успешного ответа (CARFAX+Autocheck)

{
  "success": true,
  "vin": "4JGFB4FB8SB491277",
  "precheck_usa_history": {
    "available": true,
    "records_count": 15
  },
  "precheck_usa_auction_data": {
    "available": true,
    "records_count": 36
  },
  "vehicle_info": "Mercedes-Benz Gle Gle 350 4Matic 2025"
}

Пример успешного ответа (Автотека)

{
  "success": true,
  "vin": "WBA11ES04MWX27377",
  "precheck_autoteka": {
    "available": true,
    "brand": "BMW",
    "model": "SERIE 5",
    "year": 2021
  }
}

Пример успешного ответа (РБ и аукционы ЕС)

{
  "success": true,
  "vin": "WVWZZZ3CZKE093181",
  "precheck_rb_data": {
    "available": true
  },
  "precheck_eu_auctions": {
    "available": true,
    "date": "22.02.2024",
    "title": "Volkswagen Passat B8"
  },
  "vehicle_info": "Volkswagen Passat B8"
}

Коды ошибок

Код Описание
400 Некорректный VIN или отсутствуют обязательные поля
402 Недостаточно средств на балансе. Pre-check доступен только при положительном балансе
403 Неверный API-ключ
429 Слишком частые запросы. Rate limit: 1 запрос в 1 секунду
502 Сервис временно недоступен

🔑 Получение API-ключа и поддержка

Для получения API-ключа и пополнения баланса обратитесь к администратору

✕ 🌐 English version available → vagvin.ru in English