API проверки китайских авто по VIN — документация, примеры кода, интеграция

China Vehicle History API — единственный программный интерфейс для получения истории китайских автомобилей: ДТП, пробег, владельцы, страховые записи, сервисное обслуживание. Российские API (Автокод, Автотека, SpectrumData) работают с базами ГИБДД и РСА, но не содержат данных из китайских источников. Международные VIN-сервисы (Vincario, Carfax, VinAudit) покрывают рынки США и Европы, но не Китай. Наш API заполняет этот пробел.

В этом руководстве — полная документация по API: аутентификация, эндпоинты, примеры запросов и ответов на Python, Node.js и PHP, структура JSON-ответов и интеграция с CRM. Материал для разработчиков и технических специалистов, которые интегрируют проверку китайских авто по VIN в свои системы.

Быстрый старт — первый запрос за 5 минут

API использует стандартный REST-протокол. Все запросы и ответы — в формате JSON. Аутентификация — через API-ключ в заголовке Authorization.

Базовый URL и аутентификация

Base URL: https://api.chinavehiclehistory.com/v1
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

API-ключ выдаётся после регистрации в партнёрской программе. Для получения ключа свяжитесь с нами через WhatsApp или Telegram — доступ предоставляется B2B-клиентам (автосалоны, компании по пригону авто из Китая, разработчики автомобильных сервисов).

Первый запрос — расшифровка VIN (cURL)

curl -X POST https://api.chinavehiclehistory.com/v1/decode \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vin": "LGXCE6CB9P0123456"}'

Пример ответа

{
  "success": true,
  "data": {
    "vin": "LGXCE6CB9P0123456",
    "brand": "BYD",
    "model": "Song Plus DM-i",
    "year": 2023,
    "plant": "Shenzhen",
    "engine": "BYD476ZQB",
    "engine_volume": "1.5L",
    "fuel_type": "PHEV",
    "transmission": "E-CVT",
    "body_type": "SUV",
    "color": "White",
    "power_kw": 81,
    "battery_capacity_kwh": 18.3,
    "curb_weight_kg": 1780,
    "made_in": "China"
  }
}

Примеры — не реальные данные

Все VIN-номера, URL-адреса и ответы в этом руководстве — примеры для демонстрации структуры API. Реальный базовый URL, ключи и формат ответов предоставляются при подключении к партнёрской программе.

Справочник эндпоинтов

API предоставляет 6 эндпоинтов, покрывающих полный цикл проверки китайского автомобиля: от расшифровки VIN до получения сервисной истории.

1. POST /v1/decode — Расшифровка VIN (Basic)

Возвращает заводские характеристики автомобиля по VIN: марка, модель, год, двигатель, трансмиссия, тип кузова, масса, тип топлива. Синхронный запрос — ответ приходит мгновенно.

// Запрос
POST /v1/decode
{
  "vin": "LGXCE6CB9P0123456",
  "email": "partner@example.com",
  "plan": "basic"
}

// Ответ
{
  "success": true,
  "data": {
    "brand": "BYD",
    "model": "Song Plus DM-i",
    "series": "Song Plus",
    "year": 2023,
    "price_cny": 159800,
    "engine": "BYD476ZQB 1.5L",
    "power_kw": 81,
    "transmission": "E-CVT",
    "fuel_type": "PHEV",
    "body_type": "SUV",
    "dimensions": "4705x1890x1680mm",
    "curb_weight_kg": 1780,
    "fuel_consumption_l100km": 4.4,
    "plant": "Shenzhen"
  },
  "fromCache": false
}

2. POST /v1/history — Полная история (Standard)

Возвращает характеристики + страховую историю из китайских баз: записи о ДТП, страховые выплаты (PICC, Ping An, CPIC), хронология пробега, количество владельцев, статус угона и залога. Синхронный запрос.

// Запрос
POST /v1/history
{
  "vin": "LGXCE6CB9P0123456",
  "email": "partner@example.com",
  "plan": "standard"
}

// Ответ (фрагмент)
{
  "success": true,
  "data": {
    "vehicleInfo": { ... },
    "insuranceInfo": {
      "total_claims": 2,
      "claims": [
        {
          "date": "2024-03-15",
          "type": "collision",
          "amount_cny": 8500,
          "description": "Rear bumper damage",
          "insurer": "PICC"
        },
        {
          "date": "2024-09-22",
          "type": "minor_scratch",
          "amount_cny": 1200,
          "description": "Left door scratch",
          "insurer": "Ping An"
        }
      ],
      "mileage_records": [
        {"date": "2023-06-01", "km": 5200},
        {"date": "2024-01-15", "km": 18400},
        {"date": "2024-09-22", "km": 34100}
      ],
      "owners_count": 1,
      "theft_status": "clear",
      "lien_status": "clear"
    }
  }
}

3. POST /v1/premium — Полный отчёт с сервисной историей (Premium, асинхронный)

Включает всё из Standard + записи ТО от авторизованных дилеров и независимых сервисов, статус отзывных кампаний. Асинхронный запрос — API возвращает order_id, по которому вы проверяете статус и получаете результат. Поддерживает webhook (callback_url) для уведомления о готовности отчёта.

// Запрос
POST /v1/premium
{
  "vin": "LGXCE6CB9P0123456",
  "email": "partner@example.com",
  "plan": "premium",
  "engine": "BYD476ZQB",
  "callback_url": "https://yoursite.com/webhook/report-ready"
}

// Ответ
{
  "success": true,
  "order_id": "ord_abc123def456",
  "status": "processing",
  "message": "Report is being generated. Poll /v1/premium/status/ord_abc123def456 or wait for webhook."
}

Некоторые бренды требуют номер двигателя

Для получения сервисной истории некоторых марок (Volkswagen, Toyota, BMW — параллельный импорт) необходимо передать параметр engine. Используйте эндпоинт /v1/maintenance/brands, чтобы проверить требования для конкретного бренда.

4. GET /v1/premium/status/{orderId} — Статус премиум-отчёта

Проверяет статус обработки асинхронного премиум-отчёта. Возвращает статус (pending, processing, completed, failed) и процент готовности.

// Запрос
GET /v1/premium/status/ord_abc123def456?email=partner@example.com

// Ответ
{
  "success": true,
  "status": "completed",
  "progress": 100
}

5. GET /v1/premium/results/{orderId} — Результат премиум-отчёта

Получает готовый премиум-отчёт после завершения обработки. Возвращает vehicleInfo, insuranceInfo и массив maintenanceRecords с записями от авторизованных сервисов.

// Запрос
GET /v1/premium/results/ord_abc123def456?email=partner@example.com

// Ответ (фрагмент)
{
  "success": true,
  "data": {
    "vehicleInfo": { ... },
    "insuranceInfo": { ... },
    "maintenanceRecords": [
      {
        "date": "2023-08-10",
        "mileage_km": 10200,
        "service_type": "Scheduled maintenance",
        "items": ["Engine oil change", "Oil filter", "Air filter"],
        "dealer": "BYD Shenzhen Authorized Service",
        "oem_parts": true
      },
      {
        "date": "2024-05-20",
        "mileage_km": 25600,
        "service_type": "Scheduled maintenance",
        "items": ["Brake fluid replacement", "Cabin air filter", "Battery health check"],
        "dealer": "BYD Guangzhou Service Center",
        "oem_parts": true
      }
    ]
  }
}

6. POST /v1/lookup/plate — Поиск VIN по госномеру

Находит VIN автомобиля по китайскому государственному номеру. Полезно, когда у клиента есть номер, но нет VIN.

// Запрос
POST /v1/lookup/plate
{
  "license_plate": "京A12345",
  "vehicle_type": "02"
}

// Ответ
{
  "success": true,
  "vin": "LGXCE6CB9P0123456"
}

Примеры кода — Python

import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://api.chinavehiclehistory.com/v1"

def decode_vin(vin: str) -> dict:
    response = requests.post(
        f"{BASE_URL}/decode",
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json"
        },
        json={
            "vin": vin,
            "email": "partner@example.com",
            "plan": "basic"
        }
    )
    response.raise_for_status()
    return response.json()

def get_history(vin: str) -> dict:
    response = requests.post(
        f"{BASE_URL}/history",
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json"
        },
        json={
            "vin": vin,
            "email": "partner@example.com",
            "plan": "standard"
        }
    )
    response.raise_for_status()
    return response.json()

# Пример использования
result = decode_vin("LGXCE6CB9P0123456")
print(f"Марка: {result['data']['brand']}")
print(f"Модель: {result['data']['model']}")
print(f"Год: {result['data']['year']}")

Примеры кода — Node.js

const API_KEY = "YOUR_API_KEY";
const BASE_URL = "https://api.chinavehiclehistory.com/v1";

async function decodeVin(vin) {
  const response = await fetch(`${BASE_URL}/decode`, {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${API_KEY}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      vin,
      email: "partner@example.com",
      plan: "basic"
    })
  });

  if (!response.ok) {
    throw new Error(`API error: ${response.status}`);
  }

  return response.json();
}

async function getHistory(vin) {
  const response = await fetch(`${BASE_URL}/history`, {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${API_KEY}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      vin,
      email: "partner@example.com",
      plan: "standard"
    })
  });

  if (!response.ok) {
    throw new Error(`API error: ${response.status}`);
  }

  return response.json();
}

// Пример использования
const result = await decodeVin("LGXCE6CB9P0123456");
console.log(`Марка: ${result.data.brand}`);
console.log(`Модель: ${result.data.model}`);

Примеры кода — PHP

<?php

$apiKey = "YOUR_API_KEY";
$baseUrl = "https://api.chinavehiclehistory.com/v1";

function decodeVin(string $vin): array {
    global $apiKey, $baseUrl;

    $ch = curl_init("$baseUrl/decode");
    curl_setopt_array($ch, [
        CURLOPT_POST => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => [
            "Authorization: Bearer $apiKey",
            "Content-Type: application/json"
        ],
        CURLOPT_POSTFIELDS => json_encode([
            "vin" => $vin,
            "email" => "partner@example.com",
            "plan" => "basic"
        ])
    ]);

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    if ($httpCode !== 200) {
        throw new Exception("API error: $httpCode");
    }

    return json_decode($response, true);
}

// Пример использования
$result = decodeVin("LGXCE6CB9P0123456");
echo "Марка: " . $result["data"]["brand"] . "\n";
echo "Модель: " . $result["data"]["model"] . "\n";

Обработка ошибок

API возвращает стандартные HTTP-коды статуса. Рекомендуется обрабатывать следующие коды в вашем приложении:

200 OK — запрос выполнен успешно, данные в теле ответа
400 Bad Request — некорректный VIN (не 17 символов), отсутствуют обязательные поля (vin, email, plan)
401 Unauthorized — неверный или отсутствующий API-ключ в заголовке Authorization
404 Not Found — автомобиль не найден в базе данных по указанному VIN или госномеру
429 Too Many Requests — превышен лимит запросов. Используйте экспоненциальный backoff перед повторной попыткой
500 Internal Server Error — ошибка на стороне сервера. Повторите запрос через 5–10 секунд

Кто использует API — сценарии интеграции в России

API проверки китайских авто по VIN интегрируется в несколько типов бизнес-систем на российском рынке:

Компании по пригону авто из Китая — автоматическая проверка каждого автомобиля перед закупкой на аукционе. VIN поступает от агента в Китае, API возвращает историю, менеджер принимает решение о покупке
Автосалоны — интеграция в DMS (Dealer Management System). При приёме trade-in автомобиля с китайской историей менеджер сканирует VIN, система автоматически запрашивает отчёт
Автомобильные маркетплейсы — обогащение объявлений проверенными данными. Продавец вводит VIN, платформа показывает покупателю верифицированную историю
CRM-системы (Bitrix24, AmoCRM, 1C) — автоматический запрос отчёта при создании сделки. Менеджер вносит VIN в карточку клиента, CRM через webhook вызывает API и прикрепляет отчёт к сделке
Страховые компании — оценка рисков при страховании импортных автомобилей. API показывает историю ДТП и страховых выплат в Китае, которые не видны в российских базах
Таможенные брокеры — получение точных технических характеристик для расчёта пошлин при растаможке китайских автомобилей

Сравнение с другими API на рынке

На российском и международном рынке существует несколько API для проверки автомобилей. Ни один из них не предоставляет историю китайских автомобилей:

Автокод API — данные ГИБДД, РСА, ЕАИСТО. Отличная инфраструктура, но только российские источники. Для авто, ввезённого из Китая, покажет данные только с момента постановки на учёт в РФ
Автотека API — аналогично Автокоду. Данные из российских страховых компаний и сервисных станций. Китайская история отсутствует
SpectrumData API — российские данные с хорошей Swagger-документацией. Нет китайских источников
Vincario API — европейский сервис, версия 3.2 с хорошей документацией. Покрывает спецификации китайских авто, но НЕ историю (ДТП, пробег, владельцы)
17VIN — китайские спецификации и каталог запчастей. Есть данные от CATARC, но НЕ история автомобиля (ДТП, страховые, сервисная)
China Vehicle History API — единственный API с историей из китайских баз: ДТП, страховые записи (PICC, Ping An, CPIC), хронология пробега, сервисная история, данные о владельцах

Тарифы API

API доступен по трём тарифным планам с предоплаченным кредитом:

Basic ($20/отчёт) — до 100 запросов в месяц, полный доступ к API, стандартная поддержка
Professional ($18/отчёт) — 100–500 запросов в месяц, полный доступ, приоритетная поддержка
Enterprise ($16/отчёт) — 1000+ запросов в месяц, полная функциональность, выделенный менеджер, индивидуальные условия

Для оптовых объёмов и индивидуальных условий свяжитесь с нами. Подробнее о тарифах — на странице API.

Часто задаваемые вопросы

Какие китайские бренды поддерживаются?

Все основные китайские производители: BYD, Geely, Great Wall (Haval, Tank, Poer), Changan, Chery (Tiggo, Omoda, Jaecoo), GAC, SAIC (MG), Zeekr, NIO, Xpeng, Li Auto, Voyah, Dongfeng, FAW, BAIC, Jetour, Deepal, Avatr. Также поддерживаются автомобили иностранных брендов, произведённые на китайских заводах (параллельный импорт). Полный список — в справочнике производителей.

Можно ли попробовать API перед покупкой?

Да. Начните с бесплатной расшифровки VIN на сайте, чтобы оценить качество данных. Для тестирования API-доступа свяжитесь с нами — предоставим тестовые запросы.

Чем API отличается от ручной проверки на сайте?

Данные одинаковые. Разница в способе доступа: через сайт — вручную, один VIN за раз. Через API — программно, интегрировано в вашу систему, автоматически при поступлении нового автомобиля. API подходит для компаний, проверяющих от 50 автомобилей в месяц.

Есть ли webhook для асинхронных отчётов?

Да. При запросе Premium-отчёта передайте параметр callback_url — API отправит POST-запрос на ваш URL, когда отчёт будет готов. Это удобнее, чем поллинг статуса.

Как получить API-ключ

Свяжитесь с нами через WhatsApp или Telegram для получения API-ключа и обсуждения тарифа. Расскажите о вашем бизнесе и предполагаемом объёме запросов — мы подберём оптимальный план. Сравните наше предложение с другими сервисами в статье Carfax vs China Vehicle History. Подробнее о партнёрской программе — в статье франшиза VIN-отчётов.