🔌 API vagvin.ru

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

📡 Эндпоинт API

Content-Type: application/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
}

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

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

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

Content-Type: application/json

Параметры

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

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
}

Поля ответа

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

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

Content-Type: application/json

Параметры

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

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
}

Поля ответа

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

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

Content-Type: application/json

Параметры

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

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": "Оплатите по ссылке из приложения банка. Баланс зачислится автоматически."
}

Поля ответа

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

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

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

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

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

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

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

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

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

Эндпоинты

Проверка наличия записей в базах истории США. Ответ: 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)

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

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

Пример успешного ответа (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"
}

Коды ошибок