企信通機動車合格證
API接口規(guī)范
一、概述
《企信通機動車合格證API接口規(guī)范》（以下簡稱本規(guī)范）是由湖北企信通科技有限公司（以下簡稱本公司）研發(fā)，并實現2024年現行機動車合格證二維碼規(guī)范進行解析的功能，解析并返回機動車合格證二維碼中包括的合格證上的1-35項的信息。此功能僅限公司內部管理使用，嚴禁用于非法用途；
二、 接口規(guī)范
本規(guī)范主要是企信通機動車合格證平臺解碼通用接口規(guī)范。包括：通用接口中參數及返回值說明等內容。
2.1 協(xié)議格式
2.1.1 通信協(xié)議
● 請求參數與返回參數都以JSON 格式作為數據格式
● 字符集默認使用 UTF-8,請勿使用其它字符集
● 所有業(yè)務接口默認為post
2.1.2 數據約束
● 與日期，時間有關的信息以yyyy-MM-dd HH:mm:ss格式傳輸
● 業(yè)務接口非必填參數可不傳，若傳，則參數值不能為空
2.2 系統(tǒng)級參數約束
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 去除協(xié)議、域名、參數，以 / 開頭，如：
/api/wtorg/vehicle_certificate
● 使用 HMAC-SHA256 協(xié)議創(chuàng)建基于哈希的消息身份驗證代碼 (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 | 返回時間 |
三、平臺方提供的接口
接口地址：請聯(lián)系五通軟件公司獲取！
3.1 解碼機動車合格證接口
Url路徑：vehicle_certificate
描述：用于將機動車合格證二維碼值內容解碼。
3.1.1 接口請求模型
參數代碼 | 參數類型參數類型 | 參數長度 | 代碼標識說明 | 是否非空 | 說明 |
QrCode | string | 4000 | Y | 機動車合格證二維碼值 |
3.1.2 接口返回模型
序號 | 列名 | 數據類型 | 長度 | 允許空 | 列說明 |
1 | WZHGZBH | string | (4000) | √ | 合格證編號 |
2 | FZRQ | string | (400) | √ | 發(fā)證日期 |
3 | CLZZQYMC | string | (4000) | √ | 車輛生產單位企業(yè)名稱 |
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) | √ | 發(fā)動機型號 |
13 | FDJH | string | (4000) | √ | 發(fā)動機號 |
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) | √ | 輪胎規(guī)格 |
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": "輪輞,迎賓燈；發(fā)動機凈功率值:139kW.", "qybz": "Q/GQFT 263-2023《豐田(TOYOTA)牌GTM6521SHEVR型混合動力多用途乘用車企業(yè)產品標準》", "cpscdz": "廣州市南沙區(qū)黃閣鎮(zhèn)市南大道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、此接口規(guī)范及使用，僅限公司內部管理使用，嚴禁用于非法用途；
4.2、僅針對接口調用方提交的數據進行解析服務，并返回接口文件檔中的數據字段；返回解析結果由接口調用方自行處理，與企信通軟件無關且企信通軟件不承擔任何責任；
4.3、企信通軟件不存儲接口調用方提交的數據的解析結果；
4.4、通常情況下，接口服務器在接收到請求數據后，返回解析結果的響應時間會在1S左右。實際使用時響應時間不排除雙方網絡波動或其它因素等造成的網絡延遲或解析延遲的情況；
更多功能定制需求，請與五通軟件公司聯(lián)系！
