Довідник API · Декодування

Декодування VIN

Рік, марка, модель, комплектація, двигун, тип кузова та інше за 17-значним VIN.

GET https://api.autoparse.io/v1/vin/decode/{vin}

1 кредит за успішний запит. Невдалі запити не тарифікуються.

Вперше з цим ендпоінтом? Прочитайте огляд: API декодування VIN.

Огляд

Ендпоінт декодування VIN зчитує 17-значний ідентифікаційний номер транспортного засобу та повертає закодовані в ньому характеристики: виробника, модельний рік, комплектацію, двигун, трансмісію, привід, тип кузова, завод-виробник і обладнання безпеки. Кожне поле нормалізоване й структуроване, тож його можна зберігати, шукати й показувати без розбору вільного тексту.

Типові сценарії використання

Автоматично заповнюйте рік, марку, модель і комплектацію, щойно продавець чи клієнт вводить VIN
Перевіряйте й нормалізуйте VIN, перш ніж вони потраплять до вашої бази даних
Забезпечте пошук і фільтрацію за типом кузова, приводом, пальним чи заводом

Поля відповіді

Поле	Опис
`vin`	Надісланий VIN, повернутий у нормалізованому вигляді великими літерами.
`year, make, model, trim`	Основна ідентифікація авто в заводській конфігурації, зокрема комплектація.
`engine`	Модель двигуна, виробник, тип пального, циліндри та об’єм у літрах і кубічних дюймах.
`transmission`	Тип і вид трансмісії, наприклад автоматична чи механічна.
`drivetrain`	Ведучі колеса, як-от FWD, RWD, AWD чи 4WD.
`exterior`	Тип кузова, кількість дверей і повна дозволена маса.
`plant`	Завод, на якому зібрано авто, місто й країна.
`safety`	Ремені безпеки, контроль тиску в шинах і подушки безпеки за рядами.

Параметри

Назва	Розташування	Тип	Опис
`vin`обов’язковий	path	string	17-character Vehicle Identification Number. ^[A-HJ-NPR-Z0-9]{17}$ напр. `2G1FK1EJ6A9133857`

Запит

cURL

curl "https://api.autoparse.io/v1/vin/decode/2G1FK1EJ6A9133857" \
  -H "x-api-key: $AUTOPARSE_API_KEY"

Відповідь

200 OK

{
  "vin": "2G1FK1EJ6A9133857",
  "body": "Coupe",
  "make": "Chevrolet",
  "trim": "2SS",
  "year": 2010,
  "model": "Camaro",
  "plant": "Oshawa, Ontario, Canada",
  "engine": {
    "fuel": "Gasoline",
    "model": "L99",
    "cylinders": 8,
    "injection": "Sequential Fuel Injection (SFI)",
    "other_info": "Alum",
    "manufacturer": "GM",
    "displacement_l": 6.2,
    "displacement_cc": "6,200 cc",
    "displacement_ci": "378.35 ci"
  },
  "safety": {
    "tpms": "Direct",
    "air_bags": {
      "side": "1st Row (Driver And Passenger)",
      "front": "1st Row (Driver And Passenger)",
      "curtain": "All Rows"
    },
    "seat_belts": "Manual"
  },
  "exterior": {
    "gvwr": "Class 1: 6,000 Lb Or Less (2,722 Kg Or Less)",
    "doors": 2
  },
  "manufacturer": "General Motors LLC",
  "transmission": {
    "style": "Automatic"
  },
  "vehicle_type": "Passenger Car"
}

Помилки

Типові відповіді: 400 недійсний параметр, 401 неправильний ключ, 402 недостатньо кредитів, 404 немає даних, 429 перевищено ліміт. Повний перелік дивіться в розділі Помилки.