企信通机动车合格证
API接口规范
一、概述
《企信通机动车合格证API接口规范》（以下简称本规范）是由湖北企信通科技有限公司（以下简称本公司）研发，并实现2024年现行机动车合格证二维码规范进行解析的功能，解析并返回机动车合格证二维码中包括的合格证上的1-35项的信息。此功能仅限公司内部管理使用，严禁用于非法用途；
二、 接口规范
本规范主要是企信通机动车合格证平台解码通用接口规范。包括：通用接口中参数及返回值说明等内容。
2.1 协议格式
2.1.1 通信协议
● 请求参数与返回参数都以JSON 格式作为数据格式
● 字符集默认使用 UTF-8,请勿使用其它字符集
● 所有业务接口默认为post
2.1.2 数据约束
● 与日期，时间有关的信息以yyyy-MM-dd HH:mm:ss格式传输
● 业务接口非必填参数可不传，若传，则参数值不能为空
2.2 系统级参数约束
2.3.1 请求说明
客户端在请求时，需要按照如下步骤生成签名 Signature，并添加公共参数！
2.3.2 公共请求参数
在原始请求的基础上添加 Header 请求参数：
参数名称 | 参数类型 | 必填 | 说明 |
accessKey | string | Y | 身份标识（企信通公司分配） |
timestamp | long | Y | 时间戳，精确到秒 |
nonce | int | Y | 唯一随机数，建议为一个6位的随机数 |
sign | string | Y | 签名数据（见“计算签名”部分） |
计算签名
● 按照如下顺序对请求中的参数进行排序，各个参数通过&进行拼接（中间不含空格）：
method & url & accessKey & timestamp & nonce
■ method 需要大写，如：GET
■ url 去除协议、域名、参数，以 / 开头，如：
/api/wtorg/vehicle_certificate
● 使用 HMAC-SHA256 协议创建基于哈希的消息身份验证代码 (HMAC)，以 appSecret 作为密钥，对上面拼接的参数进行计算签名，所得签名进行 Base-64 编码
HMAC-SHA256 在线计算：https://1024tools.com/hmac
2.3.3 返回说明
返回结果采用 JSON 格式，包含code、message、result等字段
参数名称 | 参数类型 | 必填 | 说明 |
code | Integer | Y | 200 标识成功，非200 失败 |
type | string | Y | 返回类型，如成功：success |
message | string | 失败时，返回原因 | |
result | object | 返回数据，json 格式 | |
extras | object | 返回数据，json 格式 | |
time | datetime | 返回时间 |
三、平台方提供的接口
接口地址：请联系五通软件公司获取！
3.1 解码机动车合格证接口
Url路径：vehicle_certificate
描述：用于将机动车合格证二维码值内容解码。
3.1.1 接口请求模型
参数代码 | 参数类型参数类型 | 参数长度 | 代码标识说明 | 是否非空 | 说明 |
QrCode | string | 4000 | Y | 机动车合格证二维码值 |
3.1.2 接口返回模型
序号 | 列名 | 数据类型 | 长度 | 允许空 | 列说明 |
1 | WZHGZBH | string | (4000) | √ | 合格证编号 |
2 | FZRQ | string | (400) | √ | 发证日期 |
3 | CLZZQYMC | string | (4000) | √ | 车辆生产单位企业名称 |
4 | CLPP | string | (4000) | √ | 车辆品牌 |
5 | CLMC | string | (4000) | √ | 车辆名称 |
6 | CLXH | string | (4000) | √ | 车辆型号 |
7 | CLSBDH | string | (4000) | √ | 车辆识别代号 |
8 | CSYS | string | (4000) | √ | 车辆颜色 |
9 | DPXH | string | (4000) | √ | 底盘型号 |
10 | DPID | string | (4000) | √ | 底盘ID |
11 | DPHGZBH | string | (4000) | √ | 底盘合格证编号 |
12 | FDJXH | string | (4000) | √ | 发动机型号 |
13 | FDJH | string | (4000) | √ | 发动机号 |
14 | RLZL | string | (4000) | √ | 燃料种类 |
15 | PL | string | (4000) | √ | 排量 |
16 | GL | string | (4000) | √ | 功率 |
17 | PFBZ | string | (4000) | √ | 排放标准 |
18 | YH | string | (4000) | √ | 油耗 |
19 | WKC | string | (4000) | √ | 外廓长 |
20 | WKK | string | (4000) | √ | 外廓宽 |
21 | WKG | string | (4000) | √ | 外廓高 |
22 | HXNBC | string | (4000) | √ | 货箱内部长 |
23 | HXNBK | string | (4000) | √ | 货箱内部宽 |
24 | HXNBG | string | (4000) | √ | 货箱内部高 |
25 | GBTHPS | string | (4000) | √ | 钢板弹簧片数 |
26 | LTS | string | (4000) | √ | 轮胎数 |
27 | LTGG | string | (4000) | √ | 轮胎规格 |
28 | QLJ | string | (4000) | √ | 前轮距 |
29 | HLJ | string | (4000) | √ | 后轮距 |
30 | ZJ | string | (4000) | √ | 轴距 |
31 | ZH | string | (4000) | √ | 轴荷 |
32 | ZS | string | (4000) | √ | 轴数 |
33 | ZXXS | string | (4000) | √ | 转身形式 |
34 | ZZL | string | (4000) | √ | 总质量 |
35 | EDZZL | string | (4000) | √ | 额定载质量 |
36 | ZBZL | string | (4000) | √ | 整备质量 |
37 | ZZLLYXS | string | (4000) | √ | 载质量利用系数 |
38 | ZQYZZL | string | (4000) | √ | 准索引总质量 |
39 | BGCAZZDYXZZL | string | (4000) | √ | 半挂车鞍座最大允许总质量 |
40 | JSSZCRS | string | (4000) | √ | 驾驶室准乘人数 |
41 | EDZK | string | (4000) | √ | 额定载客 |
42 | ZGCS | string | (4000) | √ | 最高设计车速 |
43 | CLZZRQ | string | (400) | √ | 车辆制造日期 |
以上返回数据参考按2024现行机动车合格证文件的1-35项记录，如下图所示：
Demo:
Request:
{ "qrCode": "ZCCCHGZ_V3.1 141030#1184|C206A0012319…………"}Response（部分信息涉密，已被隐藏，测试账号使用时，会有部分内容被隐藏！）:
{ "code": 200, "type": "success", "message": "", "result": { "cph": "ASVXF7…………", "pc": "368", "ggsxrq": "2023-03-10", "wzhgzbh": "YE8085000…………", "fzrq": "2023年09月28日", "clzzqymc": "广汽丰田汽车有限公司", "cllx": "乘用车及客车", "clmc": "混合动力多用途乘用车", "clpp": "丰田牌/TOYOTA", "clxh": "GTM65…………", "csys": "白", "clsbdh": "LVGDD4A…………50", "cjh": "", "fdjh": "LG2……", "fdjxh": "A25D", "rlzl": "混合动力", "pfbz": "GB18352.6-2016 国Ⅵ", "pl": "2487", "gl": "139", "zxxs": "方向盘", "qlj": "1725", "hlj": "1726", "lts": "4", "ltgg": "235/60R18", "zj": "3060", "zh": "1210/1590", …………………… "wkc": "5165", "wkk": "1995", "wkg": "1765", "zgcs": "180", "clzzrq": "2023年09月27日", "bz": "轮辋,迎宾灯；发动机净功率值:139kW.", "qybz": "Q/GQFT 263-2023《丰田(TOYOTA)牌GTM6521SHEVR型混合动力多用途乘用车企业产品标准》", "cpscdz": "广州市南沙区黄阁镇市南大道8号", "qyqtxx": "5.77", "clscdwmc": "广汽丰田汽车有限公司", "yh": "5.77", "pzxlh": "440101910……0007", "qrCode": "ZCCCHGZ_V3.1 141030#1184|C206A00123194……", }, "extras": null, "time": "2023-12-05 00:03:47"}四、其他说明
4.1、此接口规范及使用，仅限公司内部管理使用，严禁用于非法用途；
4.2、仅针对接口调用方提交的数据进行解析服务，并返回接口文件档中的数据字段；返回解析结果由接口调用方自行处理，与企信通软件无关且企信通软件不承担任何责任；
4.3、企信通软件不存储接口调用方提交的数据的解析结果；
4.4、通常情况下，接口服务器在接收到请求数据后，返回解析结果的响应时间会在1S左右。实际使用时响应时间不排除双方网络波动或其它因素等造成的网络延迟或解析延迟的情况；
更多功能定制需求，请与五通软件公司联系！
