Поиск

Найти реальный автомобиль по VIN (Beta)

GET/vin/{vin}

> Бета. Этот конечный пункт доступен и работает, но все еще развивается: поля ответа могут измениться, а также улучшается декодирование и соответствие каталогу. Приветствуются отзывы. Пожалуйста, пока не создавайте что-то критически важное на основе точной формы ответа.

Декодируйте 17-значный VIN в данные автомобиля и получите студийные изображения соответствующего автомобиля в одном запросе

Дополнение: должно быть включено для вашего ключа. Проверьте features.vin в /api/me; без него конечная точка возвращает 403.

Что вы получаете обратно

Декодированный автомобиль, марка, модель, год, комплектация, кузов, двигатель, трансмиссия, привод.
Блок vehicle с ближайшим автомобилем из нашего каталога и одной подписанной ссылкой на изображение на вид, который разрешен вашим планом.

Совпадение происходит автоматически: декодированные марка/модель/год/тип кузова сопоставляются с нашим каталогом, выбирая поколение, которое охватывает год выпуска автомобиля. Ознакомьтесь с vehicle.confidence, чтобы увидеть, насколько точно совпадение, и vehicle.matched: false, если ничего подходящего не существует. Декодированные данные всё равно возвращаются в этом случае.

Неверные VIN отклоняются с 400 до того, как что-либо будет оплачено. VIN, который нельзя декодировать, возвращает 404.

Параметры пути

Название	Тип	Описание
`vin` обязательно	строка	17-значный идентификационный номер транспортного средства (буквы I, O и Q никогда не используются).

Запрос

curl "https://api.vehicleimagery.com/vin/vin" \
  -H "x-api-key: YOUR_API_KEY"

200 · Расшифрованное транспортное средство плюс сопоставленный каталогный автомобиль и его изображения.

{
  "vin": "WBA8E9G50GNT47251",
  "make": "BMW",
  "model": "3 Series",
  "year": 2016,
  "trim": "328i",
  "body": "Sedan",
  "engine": {
    "name": "328i",
    "cylinders": 4,
    "displacement_ccm": 1997,
    "horsepower": 240,
    "fuel": "premium unleaded",
    "configuration": "inline"
  },
  "transmission": "AUTOMATIC",
  "drivetrain": "rear wheel drive",
  "doors": "4",
  "vehicle": {
    "matched": true,
    "confidence": "high",
    "id": 993477403,
    "brand": "BMW",
    "model": "3",
    "year": 2012,
    "variant": "Basis",
    "trim": "base",
    "color": "default",
    "images": {
      "front": "https://cdn.vehicleimagery.com/…",
      "front_left": "https://cdn.vehicleimagery.com/…"
    }
  }
}

400 · VIN не является допустимым 17-значным VIN. Ничего не списывается.

{
  "error": "Invalid VIN: expected 17 characters (letters I, O, Q are not used)."
}

403 · Дополнение с VIN не активировано для вашего ключа.

{
  "error": "The vin add-on is not enabled for your API key."
}

404 · Данные по этому VIN не найдены.

{
  "error": "No data found for this VIN.",
  "vin": "WBA8E9G50GNT47251"
}

502 · Поиск временно недоступен, повторите попытку через некоторое время. Ничего не списывается.

{
  "error": "VIN lookup temporarily unavailable."
}