🔌 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
}

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

🔔 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"
}

Коды ошибок