企信通機(jī)動(dòng)車(chē)合格證API接口規(guī)范一、概述《企信通機(jī)動(dòng)車(chē)合格證API接口規(guī)范》（以下簡(jiǎn)稱(chēng)本規(guī)范）是由湖北企信通科技有限公司（以下簡(jiǎn)稱(chēng)本公司）研發(fā)，并實(shí)現(xiàn)2024年現(xiàn)行機(jī)動(dòng)車(chē)合格證二維碼規(guī)范進(jìn)行解析的功能，解析并返回機(jī)動(dòng)車(chē)合格證二維碼中包括的合格證上的1-35項(xiàng)的信息。…

企信通機(jī)動(dòng)車(chē)合格證

API接口規(guī)范

一、概述

《企信通機(jī)動(dòng)車(chē)合格證API接口規(guī)范》（以下簡(jiǎn)稱(chēng)本規(guī)范）是由湖北企信通科技有限公司（以下簡(jiǎn)稱(chēng)本公司）研發(fā)，并實(shí)現(xiàn)2024年現(xiàn)行機(jī)動(dòng)車(chē)合格證二維碼規(guī)范進(jìn)行解析的功能，解析并返回機(jī)動(dòng)車(chē)合格證二維碼中包括的合格證上的1-35項(xiàng)的信息。此功能僅限公司內(nèi)部管理使用，嚴(yán)禁用于非法用途；

二、  接口規(guī)范

本規(guī)范主要是企信通機(jī)動(dòng)車(chē)合格證平臺(tái)解碼通用接口規(guī)范。包括：通用接口中參數(shù)及返回值說(shuō)明等內(nèi)容。

 2.1 協(xié)議格式

2.1.1  通信協(xié)議

● 請(qǐng)求參數(shù)與返回參數(shù)都以JSON 格式作為數(shù)據(jù)格式

● 字符集默認(rèn)使用 UTF-8,請(qǐng)勿使用其它字符集

● 所有業(yè)務(wù)接口默認(rèn)為post

2.1.2 數(shù)據(jù)約束

● 與日期，時(shí)間有關(guān)的信息以yyyy-MM-dd HH:mm:ss格式傳輸

● 業(yè)務(wù)接口非必填參數(shù)可不傳，若傳，則參數(shù)值不能為空

2.2 系統(tǒng)級(jí)參數(shù)約束

2.3.1 請(qǐng)求說(shuō)明

客戶端在請(qǐng)求時(shí)，需要按照如下步驟生成簽名 Signature，并添加公共參數(shù)！

2.3.2 公共請(qǐng)求參數(shù)

在原始請(qǐng)求的基礎(chǔ)上添加 Header 請(qǐng)求參數(shù)：

計(jì)算簽名

● 按照如下順序?qū)φ?qǐng)求中的參數(shù)進(jìn)行排序，各個(gè)參數(shù)通過(guò)&進(jìn)行拼接（中間不含空格）：

method & url & accessKey & timestamp & nonce

■ method 需要大寫(xiě)，如：GET

■ url 去除協(xié)議、域名、參數(shù)，以 / 開(kāi)頭，如：

/api/wtorg/vehicle_certificate

● 使用 HMAC-SHA256 協(xié)議創(chuàng)建基于哈希的消息身份驗(yàn)證代碼 (HMAC)，以 appSecret 作為密鑰，對(duì)上面拼接的參數(shù)進(jìn)行計(jì)算簽名，所得簽名進(jìn)行 Base-64 編碼

HMAC-SHA256 在線計(jì)算：https://1024tools.com/hmac

2.3.3 返回說(shuō)明

返回結(jié)果采用 JSON 格式，包含code、message、result等字段

三、平臺(tái)方提供的接口

接口地址：請(qǐng)聯(lián)系五通軟件公司獲取！

3.1 解碼機(jī)動(dòng)車(chē)合格證接口

Url路徑：vehicle_certificate

描述：用于將機(jī)動(dòng)車(chē)合格證二維碼值內(nèi)容解碼。

3.1.1 接口請(qǐng)求模型

3.1.2 接口返回模型

以上返回?cái)?shù)據(jù)參考按2024現(xiàn)行機(jī)動(dòng)車(chē)合格證文件的1-35項(xiàng)記錄，如下圖所示：

 Demo:

Request:

{  "qrCode": "ZCCCHGZ_V3.1 141030#1184|C206A0012319…………"}

Response（部分信息涉密，已被隱藏，測(cè)試賬號(hào)使用時(shí)，會(huì)有部分內(nèi)容被隱藏！）:

{ "code": 200, "type": "success", "message": "", "result": { "cph": "ASVXF7…………", "pc": "368", "ggsxrq": "2023-03-10", "wzhgzbh": "YE8085000…………", "fzrq": "2023年09月28日", "clzzqymc": "廣汽豐田汽車(chē)有限公司", "cllx": "乘用車(chē)及客車(chē)", "clmc": "混合動(dòng)力多用途乘用車(chē)", "clpp": "豐田牌/TOYOTA", "clxh": "GTM65…………", "csys": "白", "clsbdh": "LVGDD4A…………50", "cjh": "", "fdjh": "LG2……", "fdjxh": "A25D", "rlzl": "混合動(dòng)力", "pfbz": "GB18352.6-2016 國(guó)Ⅵ", "pl": "2487", "gl": "139", "zxxs": "方向盤(pán)", "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ā)動(dòng)機(jī)凈功率值:139kW.", "qybz": "Q/GQFT 263-2023《豐田(TOYOTA)牌GTM6521SHEVR型混合動(dòng)力多用途乘用車(chē)企業(yè)產(chǎn)品標(biāo)準(zhǔn)》", "cpscdz": "廣州市南沙區(qū)黃閣鎮(zhèn)市南大道8號(hào)", "qyqtxx": "5.77", "clscdwmc": "廣汽豐田汽車(chē)有限公司", "yh": "5.77", "pzxlh": "440101910……0007", "qrCode": "ZCCCHGZ_V3.1 141030#1184|C206A00123194……", }, "extras": null, "time": "2023-12-05 00:03:47"}

四、其他說(shuō)明

  4.1、此接口規(guī)范及使用，僅限公司內(nèi)部管理使用，嚴(yán)禁用于非法用途；

  4.2、僅針對(duì)接口調(diào)用方提交的數(shù)據(jù)進(jìn)行解析服務(wù)，并返回接口文件檔中的數(shù)據(jù)字段；返回解析結(jié)果由接口調(diào)用方自行處理，與企信通軟件無(wú)關(guān)且企信通軟件不承擔(dān)任何責(zé)任；

  4.3、企信通軟件不存儲(chǔ)接口調(diào)用方提交的數(shù)據(jù)的解析結(jié)果；

  4.4、通常情況下，接口服務(wù)器在接收到請(qǐng)求數(shù)據(jù)后，返回解析結(jié)果的響應(yīng)時(shí)間會(huì)在1S左右。實(shí)際使用時(shí)響應(yīng)時(shí)間不排除雙方網(wǎng)絡(luò)波動(dòng)或其它因素等造成的網(wǎng)絡(luò)延遲或解析延遲的情況；

更多功能定制需求，請(qǐng)與五通軟件公司聯(lián)系！