🔌 API vagvin.ru
Подключите проверку VIN автомобилей к вашему сервису через наш API
Автоматизируйте получение отчётов по истории обслуживания, комплектации и проверкам авто
🎯 Для чего подходит наш API?
🌐 Интеграция на сайт
Добавьте проверку VIN на ваш автомобильный сайт, площадку объявлений или портал автосалона. Клиенты получают отчёты прямо на вашем сайте.
🤖 Создание Telegram-бота
Запустите своего бота для проверки авто в Telegram. Мы обрабатываем запросы — вы получаете готовые отчёты для ваших клиентов.
📱 Мобильное приложение
Интегрируйте API в ваше iOS/Android приложение для проверки автомобилей перед покупкой.
🏢 CRM-системы автосалонов
Автоматизируйте проверку trade-in автомобилей. API интегрируется с любой CRM.
📊 Агрегаторы отчётов
Станьте партнёром и предоставляйте отчёты vagvin.ru под своим брендом с собственной наценкой.
🔄 Автоматизация процессов
Интеграция с системами автоматической оценки авто, страховыми сервисами, лизинговыми компаниями.
📡 Эндпоинт API
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 заказа для отслеживания |
⚡ Доступные команды и цены
📄 vagvin.ru/static/brands.json
⚡ Автоматические отчёты
👨💻 Запросы через дилера
🌍 Международные отчёты
🔧 Специальные запросы
💻 Примеры запросов
cURL
Python
JavaScript (Node.js)
📤 Ответ 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-ключ.
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 руб., списывается с баланса. Ответ приходит сразу — готовая ссылка на отчёт.
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). Ссылку можно открыть в браузере, отсканировать камерой банка или отправить клиенту. Баланс зачисляется автоматически после оплаты.
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 |
/api/balance. Неоплаченная ссылка просто сгорает, средства не списываются.
🔔 Webhook (получение результата)
После обработки заказа результат отправляется на указанный adress_post
| Тип | Content-Type | Когда | Результат в |
|---|---|---|---|
| A. Файл | multipart/form-data | Отчёт-документ PDF / JPG / PNG | поле File |
| B. Текст / ссылка | application/json | Ссылка на внешний отчёт, текстовый результат либо отказ «данных нет» | additional_text (при отказе также otwet_zaprosa_api) |
| C. Автотека | application/json | Только команда check_avtoteka_api | web_link, pdf_link, report_id |
Общий блок полей — есть в каждом webhook
| Поле | Описание |
|---|---|
| vin и vin_otv | VIN — оба поля всегда заполнены одинаковым значением |
| tip_site и commands | Команда заказа (одинаковые значения) |
| marka | Марка автомобиля из заказа |
| order_uiid | Ваш order_uiid из запроса (пусто, если не передавали) |
| uid | Ваш uid из запроса (пусто, если не передавали) |
| status | ok / success / error |
| Результат | status | Тип | Где данные |
|---|---|---|---|
| ✅ Отчёт-документ получен | ok | A (multipart) | поле File |
| 🔗 Отчёт-ссылка или текст | ok | B (JSON) | additional_text |
| 🔗 Автотека: ссылки | success | C (JSON) | web_link, pdf_link, report_id |
| ⚠️ Нет данных / отказ оператора | error | B (JSON) | otwet_zaprosa_api — причина текстом |
| ❌ Ошибка обработки | error | B или C (JSON) | otwet_zaprosa_api или error |
Примеры 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_full | WAUZZZF42KA030011 | Audi | RU |
check_avtoteka_api | SCBCN13S2TC024887 / XTA219040P0906805 | — | RU |
check_etka_full_api_logo | WVWZZZ3CZGE005256 | VW | RU |
fgst_txt_v2 | WAUZZZF42KA030011 | Audi | — (txt-файл) |
check_CARFAX | YV1CY59H841086079 | Volvo | EN |
check_autocheck | 1C4HJXFN3JW242680 | Jeep | EN |
check_vinhistory | 1GYS4BKLXMR473531 | Cadillac | — (EN) |
check_auktion_lot_api | 19UDE4H60PA011041 | Acura | — (EN) |
carinfo_lite_rb | VF1RFE00155388304 | Renault | RU |
check_avby | WAUZZZ4G4GN038785 | Audi | RU |
detal_obsl / detal_obsl_kompl | WVGZZZ5NZNW030990 | VW | RU |
👨💻 Запросы через дилера
| Команда | Тестовый VIN | Марка (marka) | Язык (lang) |
|---|---|---|---|
check_data_multibr_zapros | JTEBR3FJ30K226257 | Toyota | RU |
check_data_multibr_zapros | JTNBE40K903132834 | Toyota | EN |
check_data_multibr_zapros (Mercedes) | WDC2539151V206030 | Mercedes | RU |
check_data_mercedes_eva | W1NFB0KB8SB402223 | Mercedes | EN |
check_mers_dp | W1K2220211A585503 | Mercedes | EN |
check_data_bmw_full | WBA71AC0305U35351 | BMW | EN |
check_bmw_data_api | WBA71AC0305U35351 | BMW | EN |
check_data_bmw_fsc | WBACW010109C12525 | BMW | — (FSC-архив) |
check_multibr_pr_kod (комплектация) | VXKFBYHZTP1083819 | Opel | RU |
check_multibr_pr_kod (дата производства) | YV1LF0628P1983349 | Volvo | RU |
check_nomer_dws | WVGZZZCR8TD026107 | VW | EN |
check_elsa_pro_full | WAUZZZ8K1EA124543 | Audi | RU |
check_elsa_prkod_full | WAUW2AFC1EN042809 | Audi | EN |
check_erwin_full | WAUZZZ8K2EA013385 | Audi | RU |
check_cm_aktion | W1KLF4HB8RA023273 | Mercedes | — (скрин) |
volvo_probeg | YV1XZBBVFM2414739 | Volvo | EN |
🌍 Международные отчёты
| Команда | Тестовый VIN | Марка (marka) | Язык (lang) |
|---|---|---|---|
check_CarVertical | WBAUZ35010NE43083 | BMW | EN |
check_autodna | WBAUZ35010NE43083 | BMW | RU |
check_koreya_full | WBSJF0105JG965648 | BMW | EN |
check_china_strah | LFV2B2GA2N5624351 | VW | EN |
check_china_strah_to | LFV2B2F37L7742710 | VW | EN |
check_japan_strah_to | ZC83S-502378 | Toyota | RU |
carinfo_auktion_full | WF0PXXGCHPNR11289 | Ford | EN |
🇷🇺 Автокод РФ (отдельный эндпоинт)
| Эндпоинт | Тестовый VIN | Язык |
|---|---|---|
POST /api/avtocod | JMZKE5W7A00623042 | RU |
POST /api/avtocod | WDC2539191F753149 | RU |
Параметры как в обычном запросе Автокода (см. раздел выше): только api_key и vin — отчёт приходит сразу ссылкой report_link.
Пример бесплатного тестового запроса
В ответе "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 секунду на эндпоинт.
Эндпоинты
Проверка наличия записей в базах истории США. Ответ: precheck_usa_history, precheck_usa_auction_data
🔹 Тестовый VIN: 4JGFB4FB8SB491277 — есть данные (15/36 записей, Mercedes-Benz GLE 2025)
Проверка фотоотчёта по авто из США/Канады. Ответ: precheck_photo_report
🔹 Тестовый VIN: KL77LJE22RC119425 — есть данные (10 фото, CHEVROLET Trax 2024)
Проверка наличия данных об аукционных лотах. Ответ: precheck_auction_lots
Проверка наличия данных в Автотеке РФ. Ответ: precheck_autoteka
🔹 Тестовый VIN: WBA11ES04MWX27377 — есть данные (BMW SERIE 5 2021)
Проверка данных РБ и аукционов ЕС. Ответ: precheck_rb_data, precheck_eu_auctions
🔹 Тестовый VIN: WVWZZZ3CZKE093181 — есть данные (Volkswagen Passat B8)
Параметры запроса
| Параметр | Тип | Описание |
|---|---|---|
| api_key * | string | Ваш API-ключ (можно передать в заголовке X-API-Key) |
| vin * | string | VIN номер автомобиля (17 символов) |
Пример запроса
Пример успешного ответа (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-ключа и пополнения баланса обратитесь к администратору