🔌 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

Автотека РФ

119₽

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": "Команда не найдена"}`
500	Ошибка сервера обработки	`{"error": "Internal server error"}`

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

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

Формат отправки: Файл (PDF/JPG/PNG) через Multipart form-data

Дополнительные данные в webhook:

{
  "vin_otv": "JTEBR3FJ30K226257",
  "tip_site": "check_CARFAX",
  "status": "ok"
}

⚠️ Важно:

Ваш сервер должен принимать POST запросы с файлами
Рекомендуется использовать HTTPS для adress_post
Таймаут ответа от вашего сервера: 30 секунд

🧪 Тестовый VIN для проверки интеграции

Используйте для тестирования API (запрос БЕСПЛАТНЫЙ, баланс не списывается):

VIN: JTEBR3FJ30K226257
Марка: Toyota
Команда: check_data_multibr_zapros

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

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

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

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

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

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

@vinvag vinvag@bk.ru info@vagvin.ru