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

企信通機(jī)動車合格證

API接口規(guī)范

一、概述

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

二、  接口規(guī)范

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

 2.1 協(xié)議格式

2.1.1  通信協(xié)議

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

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

● 所有業(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)級參數(shù)約束

2.3.1 請求說明

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

2.3.2 公共請求參數(shù)

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

計(jì)算簽名

● 按照如下順序?qū)φ埱笾械膮?shù)進(jìn)行排序，各個(gè)參數(shù)通過&進(jìn)行拼接（中間不含空格）：

method & url & accessKey & timestamp & nonce

■ method 需要大寫，如：GET

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

/api/wtorg/vehicle_certificate

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

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

2.3.3 返回說明

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

三、平臺方提供的接口

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

3.1 解碼機(jī)動車合格證接口

Url路徑：vehicle_certificate

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

3.1.1 接口請求模型

3.1.2 接口返回模型

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

 Demo:

Request:

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

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

{ "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ā)動機(jī)凈功率值:139kW.", "qybz": "Q/GQFT 263-2023《豐田(TOYOTA)牌GTM6521SHEVR型混合動力多用途乘用車企業(yè)產(chǎn)品標(biāo)準(zhǔn)》", "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ī)范及使用，僅限公司內(nèi)部管理使用，嚴(yán)禁用于非法用途；

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

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

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

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