
车架号VIN
企业用户实名使用个人用户实名使用个人用户无法使用
传入17位车辆识别码(车架号)VIN码来获取车辆的品牌、车型年款、出厂日期、发动机类型、排量、车系等多维度车辆参数
价格
¥0元/10次
新用户免费体验,自购买起有效期1个月
选择套餐:

接口名称:VIN车架号查询
描述:输入vin车架号,查询车辆信息
请求地址 url:https://api.shuxuntech.com/v1/vin/query
请求方式 method:get/post
参数:
| 名称 | 参数位置 | 类型 | 是否必填 | 说明 |
|---|---|---|---|---|
| appKey | head | string | 是 | 数勋分配appKey |
| timestamp | head | string | 是 | unix时间毫秒值 |
| sign | head | string | 是 | 签名,说明 |
| vin | query | string | 是 | 车架号 |
签名算法说明:
数勋分配的appKey、当前unix时间毫秒值timestamp、数勋分配的appSecret、 按顺序拼接sha256加密得到sign,查看如下示例
appKey = aaa;
timestamp = 1682476904289;
appSecret = bbb;
sign = sha256(appKey+timestamp+appSecret)
正面返回:
{
"code": "0",
"msg": "成功",
"isFee": 1,
"seqNo": "bc393r21lk7mz2i6rmgt5oyp33tbcks7",
"data": {
"result": 1,
"info": {
"gearboxinfo": { //变速箱信息
"gearboxbrand": "捷特科", //变速箱品牌
"joint": null, //接口型号
"gravityoil": "4L-5L", //重力加油量
"gearboxmodel": "RE0F10D/J***17E/JATCO", //变速箱型号
"mechanicaloil": "12L" //机械加油量
},
"logo": "https://img.shuxuntech.com/vin_logo/202402/1708504285067.png", //车辆图片
"fueltype": "汽油", //燃油类型
"frontbraketype": "通风盘式", //前制动类型
"comfuelconsumption": "8.4", //油耗
"enginemodel": "QR25", //发动机型号(参考)
"gearnum": "7", //档位数
"machineoil": { //机油信息
"volume": "4.6L", //参考用量
"viscosity": "0W-20", //粘稠度
"level": "SP", //质量等级
"grade": "全合成" //机油分类
},
"len": "4897", //长 mm
"maxhorsepower": "186", //最大马力(Ps)
"price": "27.13万", //厂商指导价
"parkingbraketype": "脚刹", //驻车制动类型
"vin": "LGBR4DE43***0247", //车架号
"displacement": "2.5L", //排量(L)
"brand": "日产", //品牌
"environmentalstandards": "国六", //排放标准
"rearbraketype": "通风盘式", //后制动类型
"height": "1691", //高 mm
"drivemode": "前置前驱", //驱动方式
"ratedloadweight": null, //额定载质量
"displacementml": "2488", //排量(mL)
"iscorrect": 1, //1 VIN符合规则 0 VIN不符合规则
"groupid": "3887", //车型组ID
"weight": "1700", //重量,kg
"chassis": null, //底盘
"version": "智联豪华", //版本
"groupname": "*** 2.5L(2015.08-)", //车型组名称
"yeartype": "2021", //年款
"sizetype": "中型SUV", //尺寸类型
"seatnum": "5", //座位数
"doornum": "5", //车门数
"wheelbase": "2830", //轴距
"name": "*** 2021款 2.5L 两驱 智联豪华版", //名称
"geartype": "无级变速(CVT)", //变速箱类型
"cylindernum": "4", //气缸数(个)
"bodystructure": "承载式", //车体结构
"fuelgrade": "92号", //燃油标号
"carid": 132868, //车ID 对应车型详情API中的ID
"manufacturer": "东风日产", //厂家名称
"fuelmethod": "多点电喷", //供油方式
"engine": "QR25", //发动机
"bodytype": "SUV", //车身型式
"gearbox": "CVT无级变速(模拟7挡)", //变速箱
"fronttiresize": "235/65 R18", //前轮胎尺寸
"maxpower": "124", //最大功率 KW
"isimport": 0, //是否是进口 0国产 1进口
"reartiresize": "235/65 R18", //后轮胎尺寸
"listdate": "2020-08-13", //上市日期
"width": "1908", //宽 mm
"carlist": [ //车型列表 可能的车型
{
"name": "*** 2021款 2.5L 两驱 智联豪华版",//名称
"typeid": 1985, //类型ID
"model": "DFL649***R4", //工信部型号
"typename": "***", //类型名称
"carid": 132868 //车ID 对应车型API中的ID,
"manufacturer": "长沙***科技发展股份有限公司", //厂家名称
"enginemodel": "YCA07260N-60;YCA***45N-60;YCA0***0N-60;YCA07190N-60",//发动机型号(参考)
"doornum": "", //车门数
"len": "9220", //长 mm
"price": "79.5万", //厂商指导价
"geartype": "手动档", //变速箱类型
"width": "2500", //宽
"height": "3070" //高
}
],
"typename": "***", //车型名称 对应typeid
"marketprice": "22.13万" //市场价
}
}
}
错误返回:
{
"code": "1",
"msg": "参数错误",
"isFee": 0,
"seqNo": null,
"data": null
}
返回字段描述:
| 字段名 | 类型 | 描述 |
|---|---|---|
| code | string | 错误码 |
| msg | string | 错误描述 |
| isFee | int | 是否计费(1:计费,0:不计费) |
| seqNo | string | 调用流水号 |
| data | object | 返回数据 |
data对象说明
| 字段名 | 类型 | 描述 |
|---|---|---|
| result | int | 查询结果,1:查询成功,2:无记录 |
| info | object | 车辆信息 |
info对象说明
| 字段名 | 类型 | 描述 |
|---|---|---|
| gearboxinfo | object | 变速箱信息 |
| logo | string | 车辆图片 |
| fueltype | string | 燃油类型 |
| frontbraketype | string | 前制动类型 |
| comfuelconsumption | string | 油耗 |
| enginemodel | string | 发动机型号(参考) |
| gearnum | string | 档位数 |
| machineoil | object | 机油信息 |
| len | string | 长 mm |
| maxhorsepower | string | 最大马力(Ps) |
| price | string | 厂商指导价 |
| parkingbraketype | string | 驻车制动类型 |
| vin | string | 车架号 |
| displacement | string | 排量(L) |
| brand | string | 品牌 |
| environmentalstandards | string | 排放标准 |
| rearbraketype | string | 后制动类型 |
| height | string | 高 mm |
| drivemode | string | 驱动方式 |
| ratedloadweight | string | 额定载质量 |
| displacementml | string | 排量(mL) |
| iscorrect | string | 1 VIN符合规则 0 VIN不符合规则 |
| groupid | string | 车型组ID |
| weight | string | 重量,kg |
| chassis | string | 底盘 |
| version | string | 版本 |
| groupname | string | 车型组名称 |
| yeartype | string | 年款 |
| sizetype | string | 尺寸类型 |
| seatnum | string | 座位数 |
| doornum | string | 车门数 |
| wheelbase | string | 轴距 |
| name | string | 名称 |
| geartype | string | 变速箱类型 |
| cylindernum | string | 气缸数(个) |
| bodystructure | string | 车体结构 |
| fuelgrade | string | 燃油标号 |
| carid | string | 车ID 对应车型详情API中的ID |
| manufacturer | string | 厂家名称 |
| fuelmethod | string | 供油方式 |
| engine | string | 发动机 |
| bodytype | string | 车身型式 |
| gearbox | string | 变速箱 |
| fronttiresize | string | 前轮胎尺寸 |
| maxpower | string | 最大功率 KW |
| isimport | string | 是否是进口 0国产 1进口 |
| reartiresize | string | 后轮胎尺寸 |
| listdate | string | 上市日期 |
| width | string | 宽 mm |
| carlist | array | 车型列表 |
| typename | string | 车型名称 对应typeid |
| marketprice | string | 市场价 |
gearboxinfo变速箱信息说明
| 字段名 | 类型 | 描述 |
|---|---|---|
| gearboxbrand | string | 变速箱品牌 |
| joint | string | 接口型号 |
| gravityoil | string | 重力加油量 |
| gearboxmodel | string | 变速箱型号 |
| mechanicaloil | string | 机械加油量 |
machineoil机油信息说明
| 字段名 | 类型 | 描述 |
|---|---|---|
| volume | string | 参考用量 |
| viscosity | string | 粘稠度 |
| level | string | 质量等级 |
| grade | string | 机油分类 |
carlist车型信息说明
| 字段名 | 类型 | 描述 |
|---|---|---|
| name | string | 名称 |
| typeid | string | 类型ID |
| model | string | 工信部型号 |
| typename | string | 类型名称 |
| carid | string | 车ID |
| manufacturer | string | 厂家名称 |
| enginemodel | string | 发动机型号(参考) |
| doornum | string | 车门数 |
| len | string | 长 mm |
| price | string | 厂商指导价 |
| geartype | string | 变速箱类型 |
| width | string | 宽 |
| height | string | 高 |
code错误码说明
| code | 说明 |
|---|---|
| 0 | 成功 |
| 1 | 参数错误 |
| 2 | 无记录 |
| 3 | 第三方服务异常 |
| 4 | 签名错误 |
| 5 | 余额不足 |
| 6 | 调用频率超限 |
| 7 | 账号停用 |
| 8 | 接口已停用 |
| 9 | 联系服务商开通接口权限 |
| 10 | ip不在白名单 |
| 11 | 系统异常 |
| 12 | 实名状态错误 |
| 99 | 其他异常,具体返回为准 |
VIN车架号查询
package com.shuxun.data.impl.demo;
import com.shuxun.common.core.util.HttpUtil;
import org.apache.commons.codec.digest.DigestUtils;
import java.util.HashMap;
import java.util.Map;
public class VinQueryDemo {
private static final String APP_KEY = "您的appKey";
private static final String APP_SECRET = "您的appSecret";
private static final String API_URL = "https://api.shuxuntech.com/v1/vin/query";
public static void main(String[] args) {
String timestamp = System.currentTimeMillis()+"";
String sign = DigestUtils.sha256Hex(APP_KEY + timestamp + APP_SECRET);
Map<String, String> header = new HashMap<>(4);
header.put("appKey", APP_KEY);
header.put("timestamp", timestamp);
header.put("sign", sign);
Map<String, String> params = new HashMap<>(2);
params.put("vin", "");
// 工具类下载地址 https://file.shuxuntech.com/other/code/util.zip
String result = HttpUtil.get(API_URL, header, params);
System.out.println("返回结果="+result);
}
}
import requests
import time
import hashlib
appKey = "您的appKey"
appSecret = "您的appSecret"
url = "https://api.shuxuntech.com/v1/vin/query"
method = 'POST'
time = time.time()
timestamp = str(round(time * 1000))
print (timestamp)
tmp = appKey + timestamp + appSecret
sign = hashlib.sha256(tmp.encode("utf8")).hexdigest()
headers = {
'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8'
'appKey': appKey
'timestamp': timestamp
'sign': sign
}
params = {}
params['vin'] = ''
response = requests.post(url, data = params, headers = headers)
print (response.text)
<?php
$appKey = "您的appKey";
$appSecret= "您的appSecret";
$url = "https://api.shuxuntech.com/v1/vin/query";
$method = "POST";
$timestamp = getUnixTimestamp();
var_dump($timestamp);
$sign = hash('sha256',$appKey . $timestamp . $appSecret);
var_dump($sign);
$headers = array();
array_push($headers, "Content-Type" . ":" . "application/x-www-form-urlencoded; charset=UTF-8");
array_push($headers, "appKey" . ":" . $appKey);
array_push($headers, "timestamp" . ":" . $timestamp);
array_push($headers, "sign" . ":" . $sign);
$vin = "";
$bodys = "vin=" . $vin;
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
curl_setopt($curl, CURLOPT_POSTFIELDS, $bodys);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
if (1 == strpos("$".$url, "https://")) {
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
}
var_dump(curl_exec($curl));
function getUnixTimestamp () {
list($s1, $s2) = explode(' ', microtime());
return sprintf('%.0f',(floatval($s1) + floatval($s2)) * 1000);
}
using System;
using System.IO;
using System.Net;
using System.Net.Security;
using System.Security.Cryptography;
using System.Security.Cryptography.X509Certificates;
using System.Text;
public class ApiDemo {
private const String url = "https://api.shuxuntech.com/v1/vin/query";
private const String method = "POST";
private const String appKey = "您的appKey";
private const String appSecret = "您的appSecret";
public static void Main(string[] args) {
TimeSpan ts = DateTime.UtcNow - new DateTime(1970, 1, 1, 0, 0, 0, 0);
String timestamp = Convert.ToInt64(ts.TotalMilliseconds).ToString();
String sign = SHA256(appKey + timestamp + appSecret);
HttpWebRequest httpRequest = null;
HttpWebResponse httpResponse = null;
httpRequest = (HttpWebRequest) WebRequest.CreateDefault(new Uri(url));
httpRequest.Method = method;
httpRequest.ContentType = "application/x-www-form-urlencoded; charset=UTF-8";
httpRequest.Headers.Add("appKey", appKey);
httpRequest.Headers.Add("timestamp", timestamp);
httpRequest.Headers.Add("sign", sign);
String vin = "";
String params = "vin=" + vin;
byte[] data = Encoding.UTF8.GetBytes(params);
using (Stream stream = httpRequest.GetRequestStream()) {
stream.Write(data, 0, data.Length);
}
httpResponse = (HttpWebResponse) httpRequest.GetResponse();
Console.WriteLine(httpResponse.StatusCode);
Stream st = httpResponse.GetResponseStream();
StreamReader reader = new StreamReader(st, Encoding.GetEncoding("utf-8"));
Console.WriteLine(reader.ReadToEnd());
}
public static string SHA256(string str) {
byte[] SHA256Data = Encoding.UTF8.GetBytes(str);
SHA256Managed Sha256 = new SHA256Managed();
byte[] by = Sha256.ComputeHash(SHA256Data);
return BitConverter.ToString(by).Replace("-", "").ToLower();
}
}
java
python
php
c#
产品详情
API文档
示例代码
产品价格










