企信通(tōng)機(jī)動車(chē)合格證API接口規範一(yī)∞↑≤、概述《企信通(tōng)機(jī)動車(chē)₹→₩合格證API接口規範》（以下(xià)簡稱本規ββ☆γ範）是(shì)由湖(hú)北(běi)企信通(tōng)科(≠φ kē)技(jì)有(yǒu)限公司（以下(x'αià)簡稱本公司）研發，并實現(xiàn)♠ ‌2024年(nián)現(xiàn)行(xíng)機(jī)動車(chē™&₹)合格證二維碼規範進行(xíng)解析的(d←≈e)功能(néng)，解析并返回機(jī)動車(chē)合格≤ 證二維碼中包括的(de)合格證上(shàng)的(de)1≠∑'​-35項的(de)信息。…

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

API接口規範

一(yī)、概述

《企信通(tōng)機(jī)動車(chē)合格證API接口規範》（≠☆±以下(xià)簡稱本規範）是(shì)由湖(hú)北(běi)企信通(tō™€∏ng)科(kē)技(jì)有(yǒu)限公司（以下(xià)簡稱本公司）β€πβ研發，并實現(xiàn)2024年(nián)現(xiàn)行(xíng)機(♣ββ✔jī)動車(chē)合格證二維碼規範進行(xíng)解析的(de ≥)功能(néng)，解析并返回機(jī)動車(ch→σ∏♣ē)合格證二維碼中包括的(de)合格證上(shàng)的(de)1-↔λ≥↕35項的(de)信息。此功能(néng)僅↔₩☆限公司內(nèi)部管理(lǐ)使用(yòφγ÷ng)，嚴禁用(yòng)于非法用(yòng)途；

二、  接口規範

本規範主要(yào)是(shì)企信通(tōng)機(jī)動車(chēφγ )合格證平台解碼通(tōng)用(yòng)接口規範。包括：通(t←δ≤≈ōng)用(yòng)接口中參數(shù)及返回值說(shuō)明(míng)§♣↔&等內(nèi)容。

 2.1 協議(yì)格式

2.1.1  通(tōng)信協議(yì)

● 請(qǐng)求參數(shù)與返回參數(shù)都α ←↕(dōu)以JSON 格式作(zuò)為(wèi)數α¥(shù)據格式

● 字符集默認使用(yòng) UTF-8"‍♦•,請(qǐng)勿使用(yòng)其它字✔₽☆¶符集

● 所有(yǒu)業(yè)務接口默認為(wèi)post

2.1.2 數(shù)據約束

● 與日(rì)期，時(shí)間(jiān)有 ★>(yǒu)關的(de)信息以yyyy-M >M-dd HH:mm:ss格式傳輸

● 業(yè)務接口非必填參數(shù)可(kě)不(bù)傳，若傳，則®βΩ參數(shù)值不(bù)能(néng)為(wèi)空(kōng)

2.2 系統級參數(shù)約束

2.3.1 請(qǐng)求說(shuō)‍™×明(míng)

客戶端在請(qǐng)求時(shí)，需要(yào)按照(zhào)如©π(rú)下(xià)步驟生(shēng)成簽名 ♦§γ₹Signature，并添加公共參數(shù)！

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

在原始請(qǐng)求的(de)基礎上(shàng)添​•加 Header 請(qǐng)求參數(shù)：

計(jì)算(suàn)簽名

● 按照(zhào)如(rú)下(xià)順序對(duì)請(qǐn​¶g)求中的(de)參數(shù)進行(xíng)排≥★‌∞序，各個(gè)參數(shù)通(tōng)過&進行(xíng✘∑)拼接（中間(jiān)不(bù)含空(kōng)格）：   

method & url &÷‍∞• accessKey &&nb≥βsp;timestamp &&nbs↔εp;nonce

■ method 需要(yào)大(dà)寫，如(rú)：GET

■ url 去(qù)除協議(yì)、域名、參數(shù)，以&nbs₹•₩p;/ 開(kāi)頭，如(rú)：

/api/wtorg/vehicle_ce ™&₩rtificate

● 使用(yòng) HMAC-SHA256 協議(yì)創建♦ε←♦基于哈希的(de)消息身(shēn)份驗證代碼±'≠∑ (HMAC)，以 appSecret &←作(zuò)為(wèi)密鑰，對(duì)上(shàng)₽☆面拼接的(de)參數(shù)進行(xín₹λ♠¶g)計(jì)算(suàn)簽名，所得(de)簽名進行(xíng) ®‍ Base-64 編碼

HMAC-SHA256 在線計(jì)算(‍φ↓suàn)：https://1024tools.com/hmac

2.3.3 返回說(shuō)明(míng)

返回結果采用(yòng) JSON 格式，♣©★包含code、message、result等字段

三、平台方提供的(de)接口

接口地(dì)址：請(qǐng)聯系五通(tōng)軟件(jiàn‍✔♦✔)公司獲取！

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

Url路(lù)徑：vehicle_certificate

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

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

3.1.2 接口返回模型

以上(shàng)返回數(shù)據參考按↕$​≤2024現(xiàn)行(xíng)機(jī)動車(chē)合格證文(wénδ€₩)件(jiàn)的(de)1-35項記錄，如(rúε♠)下(xià)圖所示：

 Demo:

Request:

{  "qrCod&πe": "ZCCCHGZ_V3.1&nbs♥ε¥∑p;141030#1184|C206A0012319…… ‍↕±……"}

Response（部分(fēn)信息涉密，已被隐藏，測試賬号使用(yòng)時(shí)，會(huπγì)有(yǒu)部分(fēn)內(nèi$≤☆‌)容被隐藏！）:

{ "code":&£ 200, "type": δ​§;"success", "m≠•¥essage": &q®™∏εuot;", "result"↑πα≤: { "cp≠‌h": "• ¥₩ASVXF7…………", "pc"¥ ↕ε;: "368", "γ$∞;ggsxrq": "2023-03¥₩π-10", "wzhgzbh"₩ £ ;: "YE8085000…………"$÷ε, "fzrq": "2↓$♦♦023年(nián)09月(yuè)28日(rì)",&​λnbsp;"clzzqymc":&♦ nbsp;"廣汽豐田汽車(chē)有₩♥(yǒu)限公司", "cl™✘ lx": "乘用(yòng)車(chē)及客車(π™<chē)", "clmc"☆★;: "混合動力多(duō)♠γ'&用(yòng)途乘用(yòng)車(chē)",&n♠ §<bsp;"clpp": ₽<•™;"豐田牌/TOYOTA",&Ωλ↑nbsp;"clxh": "GTM65↕♣ …………", "csys":&nb∞'Ωsp;"白(bái)", &♦​±♦quot;clsbdh": &quεβ♠ot;LVGDD4A…………50", "↑→;cjh": "&quoΩ≠t;, "fdjh": ">±¥LG2……", "fdjxh":&nb₩"sp;"A25D", &‌↓'¶quot;rlzl": "混合動力"₽εδ§;, "pfbz": "©'GB18352.6-2016 國(guó)Ⅵ",‌" "pl": επ"§;"2487", &qu₽↑‌ot;gl": "€>♠;139", "zxxs&↓<quot;: "方向盤", &♥€©¥quot;qlj": ♣¥↓;"1725", "hlj&¥α∑>quot;: "1726",☆ε± "lts": &≠∑∞≥quot;4", &↔₽quot;ltgg": "235‍→/60R18", "zj":&nαβ®bsp;"3060", "zh&quo"♦∞t;: "1210/1590↑÷", …………………… "wkc&qαβ €uot;: "5165&quΩ≥ot;, "wkk": &quo±π↕t;1995", "↕";wkg": &quo←λ✔σt;1765", "zgcs":₽λ☆€ "180",&nb≥ γαsp;"clzzrq": "20♣₩23年(nián)09月(yuè)27日(rì)",&¶★←nbsp;"bz": &quo₹δ₹∞t;輪辋,迎賓燈；發動機(jī)淨功率值:13γ$§9kW.", "qybz":&n±£σ₽bsp;"Q/GQFT 263-2023《豐田(TOYO≈←TA)牌GTM6521SHEVR型混合動力多(duō)用(yòng)途乘用(♣≥€yòng)車(chē)企業(yè)産品标準》",&nbs↕™p;"cpscdz"♣ ‌: "廣州市(shì)南(ná>∞n)沙區(qū)黃(huáng)閣鎮市(shì)南(nán)大(dà)£π道(dào)8号", "qyqtxx"✔♠←;: "5.77",  ↔♣"clscdwmc": &↑®quot;廣汽豐田汽車(chē)有(yǒu)限公司&qu"★ot;, "yh&qu←$≤✔ot;: "5.77", 'ε"pzxlh": &qu±₽ ot;440101910……0007&quo£↓₹t;, "qrCode™★¥": "ZCCCHGZ_V3.1&n ↓•bsp;141030#1184|C206A00123194……&≠✔&≤quot;, }, &qu©♦​ot;extras": null,&nλφ‍bsp;"time": &quε≥≠"ot;2023-12-05 00:03:47&quoφ∑γ↕t;}

四、其他(tā)說(shuō)明(míng)

  4.1、此接口規範及使用(y≠✘¶òng)，僅限公司內(nèi)部管理(lǐ)使用(yòng)，∞₩β★嚴禁用(yòng)于非法用(yòng)途↓™；

  4.2、僅針對('"duì)接口調用(yòng)方提交的(de)數×™α(shù)據進行(xíng)解析服務，并返回接口文(wén)σ>件(jiàn)檔中的(de)數(shù)據字段；返回解析≈↓ ↕結果由接口調用(yòng)方自(zì)行(xíng)處理(lǐ)，與企→↑‍₹信通(tōng)軟件(jiàn)無關且企信通(tōng)軟件(jiàn)不(b>→÷ù)承擔任何責任；

  4.3、企信通(tōng)軟件(jiàn)不(bù) ∑₩存儲接口調用(yòng)方提交的(de)數(shù)據的(de)↔δ&¥解析結果；

  4.4、通(tōng)常情況下(xià)'≤，接口服務器(qì)在接收到(dào)請(qǐng)求數(shù)據後，返回解₽¥<♥析結果的(de)響應時(shí)間(jiān)會(h₹αλuì)在1S左右。實際使用(yòng)時(shí)響應時(shí)♣₩間(jiān)不(bù)排除雙方網絡波動或其它因素等造成的(δ¥de)網絡延遲或解析延遲的(de)情況；

更多(duō)功能(néng)定制(zhì)需求，請(qǐng)與五通₹✔δ∏(tōng)軟件(jiàn)公司聯系！