Giải mã số VIN API
Giải mã số VIN 17 ký tự: hợp lệ hay không, số kiểm tra, hãng và nước sản xuất (13.000 WMI), năm model, mã nhà máy, kèm chi tiết từ NHTSA vPIC nếu cần.
Gửi vin (hoặc /v1/vin-decode/<VIN>). API kiểm tra độ dài và bảng ký tự (không bao giờ dùng I, O, Q), tính số kiểm tra ở vị trí 9 (bắt buộc với xe Bắc Mỹ, nơi khác chỉ cảnh báo), tách các phần WMI / VDS / VIS, tra hãng sản xuất, nước của hãng và loại xe trong danh sách mã nhà sản xuất (WMI) của NHTSA (13.000 mã, gồm mã 6 ký tự của hãng nhỏ và các hãng Việt Nam như VinFast), xác định nước sản xuất theo dải ISO 3780 của 2 ký tự đầu, năm model theo ký tự thứ 10 (chu kỳ 30 năm được phân định bằng quy tắc ký tự thứ 7 với xe nhẹ Bắc Mỹ, các năm khả dĩ khác được liệt kê), mã nhà máy và số thứ tự xe.
online=true hỏi thêm NHTSA vPIC (công khai, không cần khoá) để lấy hãng, mẫu xe, phiên bản, kiểu thân, động cơ, nhiên liệu, nhà máy, trang bị an toàn… – chi tiết chủ yếu với xe bán tại Mỹ; kết quả được cache 30 ngày. vins giải mã tối đa 50 số VIN một lần (10 số khi dùng online).
Giải mã offline không cho biết mẫu xe của xe ngoài thị trường Mỹ: phần VDS do từng hãng tự quy ước. Dữ liệu: NHTSA vPIC (tài liệu của chính phủ Mỹ, public domain), cập nhật hàng tuần.
Tham số
| Tên | Vị trí | Kiểu | Bắt buộc | Mặc định | |
|---|---|---|---|---|---|
vin | query | string | có | Số VIN 17 ký tự (bỏ qua khoảng trắng, gạch ngang). Hoặc /v1/vin-decode/<VIN>. | |
online | query | boolean | không | false | Thêm kết quả giải mã của NHTSA vPIC (đối tượng vpic; cache 30 ngày). |
vins | body|query | array | không | Tối đa 50 số VIN (mảng hoặc phân tách bằng dấu phẩy) thay cho vin. |
Ví dụ
curl "https://apibox.io.vn/v1/vin-decode?vin=1HGCM82633A004352" \
-H "Authorization: Bearer YOUR_API_KEY"const res = await fetch('https://apibox.io.vn/v1/vin-decode?vin=1HGCM82633A004352', {
method: 'GET',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
},
});
const data = await res.json();
console.log(data);import requests
res = requests.get(
"https://apibox.io.vn/v1/vin-decode?vin=1HGCM82633A004352",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://apibox.io.vn/v1/vin-decode?vin=1HGCM82633A004352');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));Kết quả trả về
{
"vin": "1HGCM82633A004352",
"valid": true,
"warnings": [],
"wmi": "1HG",
"vds": "CM8263",
"vis": "3A004352",
"manufacturer": "AMERICAN HONDA MOTOR CO., INC.",
"manufacturer_country": "United States",
"vehicle_type": "Passenger Car",
"country_of_origin": "United States",
"region": "North America",
"wmi_known": true,
"check_digit": {
"value": "3",
"expected": "3",
"valid": true,
"required": true
},
"model_year": 2003,
"model_year_candidates": [
2003
],
"model_year_rule": "only year of the cycle not in the future",
"plant_code": "A",
"serial_number": "004352",
"sources": {
"wmi": "NHTSA vPIC manufacturer list (public domain)",
"online": null
},
"data_version": "2026-11-11"
}
Ứng dụng
- Bắt lỗi gõ sai số VIN trên sàn mua bán ô tô cũ
- Hiển thị hãng, nước sản xuất và năm model khi garage quét số VIN
- Đối chiếu xe nhập khẩu từ Mỹ với dữ liệu NHTSA trước khi đăng ký
- Kiểm tra hàng loạt số VIN trong file bảo hiểm hoặc đội xe
Hỏi đáp
Vì sao số kiểm tra của xe tôi chỉ là cảnh báo?
Số kiểm tra là bắt buộc ở Bắc Mỹ (VIN bắt đầu bằng 1–5 hoặc 7). Nhiều hãng châu Âu, châu Á không dùng, nên sai lệch được báo dưới dạng cảnh báo.
Vì sao năm model có thể không chắc chắn?
Ký tự thứ 10 lặp lại mỗi 30 năm (A = 1980, 2010, 2040). Với xe Bắc Mỹ ký tự thứ 7 giúp phân định; trường hợp khác API chọn năm gần nhất và liệt kê mọi khả năng.
Chi tiết online lấy từ đâu?
Từ dịch vụ miễn phí DecodeVinValues (vPIC) của NHTSA. Dữ liệu đầy đủ nhất với xe sản xuất cho thị trường Mỹ.
API liên quan
Kiểm tra JSON
Kiểm tra cú pháp JSON, báo đúng dòng và cột bị lỗi, và validate dữ liệu theo JSON Schema (draft 4, 7, 2019-09 hoặc 2020-12).
{ }Định dạng JSON
Làm đẹp JSON với thụt lề 0-8 dấu cách hoặc tab, rút gọn (minify) hoặc sắp xếp key theo bảng chữ cái. Báo lỗi cú pháp kèm dòng và cột.
CSVCSV sang JSON
Chuyển CSV thành mảng object JSON theo dòng tiêu đề, tự nhận dấu phân cách, tự chuyển số và boolean, báo lỗi từng dòng.