基于區(qū)塊鏈的港航集裝箱信息交換平臺及接口技術(shù)要求

JT/TXXXXX—XXXX

基于區(qū)塊鏈的港航集裝箱信息交換平臺及接口技術(shù)要求

1范圍

本文件規(guī)定了基于區(qū)塊鏈的港航集裝箱信息交換平臺要求和接口要求。

本文件適用于基于區(qū)塊鏈的港航集裝箱信息交換平臺及接口的設(shè)計和應(yīng)用。

2規(guī)范性引用文件

下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，

僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本

文件。

GB/T34990信息安全技術(shù)信息系統(tǒng)安全管理平臺技術(shù)要求和測評評價方法

JT/T1417交通運(yùn)輸行業(yè)網(wǎng)絡(luò)安全等級保護(hù)基本要求

YD/T3747區(qū)塊鏈技術(shù)架構(gòu)安全要求

RFC2616超文本傳輸協(xié)議HTTP1.1（HypertextTransferProtocol--HTTP/1.1）

3術(shù)語和定義

下列術(shù)語和定義適用于本文件。

分布式賬本distributedledger

一個可以在多個節(jié)點(diǎn)、不同地理位置或者多個機(jī)構(gòu)組成的網(wǎng)絡(luò)中分享的數(shù)據(jù)記錄。

[來源：GM/T0111—2021，3.4]

智能合約smartcontract

一套以數(shù)字形式定義的約定。

[來源：GM/T0111—2021，3.3]

節(jié)點(diǎn)node

構(gòu)建數(shù)據(jù)結(jié)構(gòu)的基本組件。

交易transaction

數(shù)字資產(chǎn)的一次轉(zhuǎn)賬或者對智能合約的一次調(diào)用。

[來源：GM/T0111—2021，3.6]

哈希值hashvalue

將任意長度的二進(jìn)制串映射為固定長度的二進(jìn)制串的函數(shù)輸出的比特串。

時間戳timestamp

以公共時間為參考的時間點(diǎn)。

4縮略語

下列縮略語適用于本文件。

gRPCs：Google發(fā)起的開源遠(yuǎn)程過程調(diào)用安全協(xié)議(googleRemoteProcedureCallsecurity

protocol）

HTTP：超文本傳輸協(xié)議（HyperTextTransferProtocol）

1

JT/TXXXXX—XXXX

JSON：腳本語言對象符號，一種輕量級的數(shù)據(jù)交換格式（JavaScriptObjectNotation）

REST：表征狀態(tài)轉(zhuǎn)移（RepresentationalStateTransfer）

SCAC：標(biāo)準(zhǔn)承運(yùn)人數(shù)字代碼（StandardCarrierAlphaCode）

URI：通用資源標(biāo)識符（UniformResourceIdentifier）

5平臺要求

一般要求

5.1.1基于區(qū)塊鏈的港航集裝箱信息交換平臺（以下簡稱“平臺”）技術(shù)架構(gòu)應(yīng)符合YD/T3747的要

求。

5.1.2平臺的安全等級應(yīng)符合GB/T34990中的增強(qiáng)級等級。

5.1.3網(wǎng)絡(luò)安全等級保護(hù)應(yīng)符合JT/T1417中的第三級安全要求。

5.1.4承運(yùn)人、貨主、貨代、船代、港口企業(yè)等業(yè)務(wù)參與方是數(shù)據(jù)交互方，應(yīng)通過平臺完成集裝箱運(yùn)

輸信息的交換。

平臺框架

平臺框架見圖1。

其他業(yè)務(wù)系統(tǒng)

集基

業(yè)務(wù)應(yīng)用層信息創(chuàng)建信息更新信息推送信息查詢信息驗證

裝于

箱

平臺服務(wù)層身份管理運(yùn)維監(jiān)測交易管理節(jié)點(diǎn)管理區(qū)

信

塊

息

分布式賬本智能合約鏈

交

節(jié)點(diǎn)節(jié)點(diǎn)節(jié)點(diǎn)

平臺基礎(chǔ)層的

密碼算法隱私保護(hù)共識機(jī)制換

節(jié)點(diǎn)平港

臺航

圖1平臺框架

業(yè)務(wù)應(yīng)用層

5.3.1信息創(chuàng)建

信息創(chuàng)建方創(chuàng)建需要上鏈的集裝箱信息并發(fā)送到平臺，平臺應(yīng)返回上鏈?zhǔn)聞?wù)信息數(shù)據(jù)。

5.3.2信息更新

信息更新方應(yīng)根據(jù)業(yè)務(wù)應(yīng)用需要，更新之前已經(jīng)創(chuàng)建過的集裝箱信息。針對同樣的信息，應(yīng)以新的

版本進(jìn)行上鏈并發(fā)送到平臺，平臺應(yīng)返回上鏈?zhǔn)聞?wù)信息數(shù)據(jù)。

5.3.3信息推送

消息上鏈成功之后，平臺應(yīng)將消息推送給該消息角色清單中的參與方。

5.3.4信息查詢

信息查詢方請求查詢鏈上集裝箱信息，平臺應(yīng)向信息查詢方返回所查詢信息的明細(xì)。

5.3.5信息驗證

2

JT/TXXXXX—XXXX

信息驗證方發(fā)送集裝箱信息驗證請求，平臺校驗數(shù)據(jù)后應(yīng)返回驗證結(jié)果。信息驗證方應(yīng)通過鏈上信

息與鏈下信息的對比來驗證鏈下信息是否有篡改。

平臺服務(wù)層

5.4.1身份管理

平臺應(yīng)支持業(yè)務(wù)參與方注冊，注冊時業(yè)務(wù)參與方應(yīng)提供統(tǒng)一社會信用代碼等信息完成身份認(rèn)

證。

平臺應(yīng)對數(shù)據(jù)交互方定期進(jìn)行身份驗證。

5.4.2運(yùn)維監(jiān)測

平臺應(yīng)能對基礎(chǔ)硬件、基礎(chǔ)軟件、性能、異常事務(wù)等進(jìn)行監(jiān)控。

業(yè)務(wù)參與方的任何操作，包括時間、數(shù)據(jù)變更內(nèi)容、操作者等信息，都應(yīng)在平臺留存記錄并

可進(jìn)行相關(guān)統(tǒng)計。

5.4.3交易管理

交易管理應(yīng)包括單證編碼的生成與發(fā)放管理、單證編碼對應(yīng)的業(yè)務(wù)參與方地址列表的管理、消息的

發(fā)送與接收管理、消息異常處理管理、交易的異常處理管理、日志管理等功能。

5.4.4節(jié)點(diǎn)管理

平臺應(yīng)支持節(jié)點(diǎn)的增加和刪除，新節(jié)點(diǎn)應(yīng)通過簽名證書相互授權(quán)準(zhǔn)入后才能加到業(yè)務(wù)相關(guān)的

通道中。

各節(jié)點(diǎn)應(yīng)在部署上物理隔離，宜通過gRPCs進(jìn)行通信。

業(yè)務(wù)相關(guān)節(jié)點(diǎn)之間應(yīng)搭建通道，每個通道應(yīng)有專屬分布式賬本，且僅對通道內(nèi)節(jié)點(diǎn)開放。

平臺應(yīng)對節(jié)點(diǎn)管理操作進(jìn)行權(quán)限控制和身份驗證，記錄所有節(jié)點(diǎn)管理的操作歷史，做到可審

計、可追溯。

平臺基礎(chǔ)層

5.5.1分布式賬本

平臺應(yīng)為港航集裝箱數(shù)據(jù)交互方建立分布式賬本，存儲信息的上鏈記錄、授權(quán)記錄、使用記

錄、查詢記錄、狀態(tài)變更等信息。

分布式賬本以塊鏈結(jié)構(gòu)實現(xiàn)數(shù)據(jù)的分布式存儲，每個節(jié)點(diǎn)都應(yīng)有獨(dú)立的、完整的數(shù)據(jù)存儲區(qū)

域，并設(shè)置隱私保護(hù)措施，僅對利益相關(guān)方選擇可見，并使用非代幣形式的記賬以及驗證交易信息。

平臺應(yīng)具備分布式賬本維護(hù)、分布式賬本數(shù)據(jù)有效性檢驗、分布式賬本數(shù)據(jù)追溯、分布式賬

本同步等功能。

5.5.2智能合約

智能合約應(yīng)包含相關(guān)數(shù)據(jù)交互方的數(shù)據(jù)交換規(guī)則和交換流程，這些規(guī)則和流程以代碼的形式

部署在區(qū)塊鏈節(jié)點(diǎn)中，當(dāng)滿足指定日期或者發(fā)生指定行為的條件時，計算機(jī)系統(tǒng)應(yīng)自動執(zhí)行相關(guān)合約。

平臺應(yīng)具備智能合約審核、發(fā)布、更新、日志審計、版本管理等功能，智能合約的發(fā)布應(yīng)引

入相關(guān)方聯(lián)合審核機(jī)制。

5.5.3密碼算法

平臺應(yīng)具備對集裝箱上鏈信息加密的能力。

密碼算法可包括分組密碼算法、流密碼算法、非對稱密碼算法、密鑰交換算法、密碼雜湊算

法和標(biāo)識密碼算法等國家商用密碼算法。

5.5.4隱私保護(hù)

平臺應(yīng)基于國家商用密碼算法采取加密傳輸、認(rèn)證和數(shù)據(jù)簽名校驗等安全機(jī)制。

3

JT/TXXXXX—XXXX

平臺在進(jìn)行信息采集、處理及發(fā)布過程中，應(yīng)采取信息安全管理措施和技術(shù)手段，并應(yīng)對隱

私數(shù)據(jù)進(jìn)行數(shù)據(jù)加密存儲。

平臺應(yīng)制定完備的隱私保護(hù)審計方案，方案應(yīng)滿足下列要求：

——審計內(nèi)容包括隱私保護(hù)策略和隱私保護(hù)技術(shù)手段；

——審查形式包括但不限于日常監(jiān)控、定期審計、不定期審計；

——審查對象包括但不限于操作記錄等支持性文檔；

——確認(rèn)執(zhí)行過程中遵循并實現(xiàn)既定的策略和技術(shù)手段。

5.5.5共識機(jī)制

平臺的共識機(jī)制應(yīng)由共識算法和共識協(xié)議等組成，應(yīng)根據(jù)交易順序?qū)懙椒植际劫~本上，并滿足在不

同場景中的一致性需求。

6接口要求

一般要求

6.1.1接口方式與協(xié)議規(guī)范

平臺提供的接口服務(wù)應(yīng)采用以系統(tǒng)資源為中心，基于REST的網(wǎng)絡(luò)服務(wù)設(shè)計方式?；赗EST的網(wǎng)絡(luò)服

務(wù)應(yīng)遵循RFC2616定義的協(xié)議方式，并應(yīng)滿足下列要求：

——顯式地使用HTTP方法，應(yīng)充分利用HTTP提供的請求信息、請求方法、響應(yīng)信息來識別請求

的服務(wù)以及返回的錯誤；

——無狀態(tài)的設(shè)計，不保留請求的狀態(tài)，同時連接應(yīng)為短連接；

——公開目錄結(jié)構(gòu)式的URI；

——傳輸JSON格式的請求體。

6.1.2接口響應(yīng)常用狀態(tài)碼

接口響應(yīng)狀態(tài)碼應(yīng)使用RFC2616規(guī)范定義的HTTP狀態(tài)碼，常用的接口響應(yīng)狀態(tài)碼及其說明應(yīng)符合

表1的規(guī)定。

表1接口響應(yīng)常用狀態(tài)碼及其說明

常用狀態(tài)碼說明

200服務(wù)調(diào)用成功

400請求格式錯誤

401未授權(quán)訪問

403服務(wù)器拒絕訪問

404指定的資源未找到

429請求數(shù)超出限額

500服務(wù)器內(nèi)部錯誤

504響應(yīng)超時

注：業(yè)務(wù)產(chǎn)生的錯誤或異常，其錯誤描述和錯誤號在HTTP響應(yīng)體中返回。

6.1.3傳輸協(xié)議

平臺應(yīng)采用HTTP傳輸協(xié)議，建立以安全為目標(biāo)的HTTP通道，在HTTP的基礎(chǔ)上通過傳輸加密和身份認(rèn)

證保證傳輸過程的安全性。

6.1.4數(shù)據(jù)格式

平臺服務(wù)宜采用JSON作為數(shù)據(jù)交換的格式。

6.1.5交互方式

平臺應(yīng)支持的HTTP交互方式包括：創(chuàng)建信息（POST）、更新信息（PUT）和獲得信息（GET）

三種方式，各接口類型的對應(yīng)交互方式的應(yīng)符合6.1.6的規(guī)定。

4

JT/TXXXXX—XXXX

接口應(yīng)采取授權(quán)準(zhǔn)入的規(guī)則，只有授權(quán)的IP方能進(jìn)行訪問。

6.1.6接口類型

平臺接口類型和交互方式應(yīng)符合表2的要求。

表2類型與交互方式

接口類型交互方式URI發(fā)送方接收方

港航集裝箱信息交換

信息創(chuàng)建POST/api/[assetType]信息創(chuàng)建方

平臺

港航集裝箱信息交換

信息更新PUT/api/[assetType]信息更新方

平臺

港航集裝箱信息交換

信息推送POST/api/push信息接收方

平臺

/api/[assetType]/港航集裝箱信息交換

信息查詢GET信息查詢方

[assetId]/version/[assetVersion]平臺

港航集裝箱信息交換

信息驗證POST/api/verify信息驗證方

平臺

6.1.7數(shù)據(jù)屬性

數(shù)據(jù)屬性包括：層次、中文名稱、英文名稱、類型、是否必填、說明，其中：

——層次：字段所屬的層次關(guān)系；

——中文名稱：字段的中文名稱；

——英文名稱：字段的英文名稱；

——說明及要求：字段的內(nèi)容和表達(dá)的含義；

——類型：數(shù)據(jù)元的特征和基本要素，包括字符型（string）、對象型（object）、數(shù)組型

(array)；

——是否必填：該數(shù)據(jù)元是否必填，必填為M、非必填為C；

——說明：字段的內(nèi)容和表達(dá)的含義。

信息創(chuàng)建接口

6.2.1接口說明

創(chuàng)建需要上鏈的信息。

6.2.2請求內(nèi)容

信息創(chuàng)建接口的請求參數(shù)數(shù)據(jù)格式和要求應(yīng)符合表3的規(guī)定。

表3信息創(chuàng)建請求頭信息數(shù)據(jù)格式要求

序號中文名稱英文名稱類型是否必填說明

信息創(chuàng)建方區(qū)塊鏈組織代碼，在區(qū)塊

1區(qū)塊鏈組織代碼orgIDstringM鏈注冊后，由區(qū)塊鏈創(chuàng)建的唯一的組

織代碼

2角色rolestringM信息創(chuàng)建方

區(qū)塊鏈業(yè)務(wù)應(yīng)用場景編區(qū)塊鏈針對業(yè)務(wù)應(yīng)用場景分配的編

3applicationIDstringM

號號

6.2.3上鏈內(nèi)容

上鏈內(nèi)容的數(shù)據(jù)格式和要求應(yīng)符合表4的規(guī)定。

5

JT/TXXXXX—XXXX

表4信息創(chuàng)建上鏈內(nèi)容數(shù)據(jù)格式要求

序號層次中文名稱英文名稱類型是否必填說明

信息創(chuàng)建方指定允許查詢的參與方

10角色清單roleListobjectM

清單

roleListLocator采集信息，供區(qū)塊鏈生成唯一上鏈信

1.11角色清單定位鍵objectM

Key息識別碼

1.1.12承運(yùn)人代碼carrierScacstringM承運(yùn)人scac代碼

1.1.22提單號blNumberstringC提單號

1.1.32提貨單號doNumberstringC提貨單號

1.1.42集裝箱號cntrNumberstringC集裝箱號

1.1.52角色清單類型roleListTypestringM角色清單類型

1.21角色清單類型roleListTypestringM角色清單類型

1.31角色清單內(nèi)容roleListContentobjectM參與方清單內(nèi)容

1.3.12承運(yùn)人組織代碼carrierOrgIDstringC承運(yùn)人在區(qū)塊鏈的組織代碼

最終卸港碼頭組lastPodTerminal

1.3.22stringC最終卸港碼頭在區(qū)塊鏈的組織代碼

織代碼OperatorOrgID

1.3.32托運(yùn)人組織代碼shipperOrgIDstringC托運(yùn)人在區(qū)塊鏈的組織代碼

貨運(yùn)代理組織代

1.3.42forwardeOrgIDstringC貨運(yùn)代理在區(qū)塊鏈的組織代碼

碼

1.3.52收貨人組織代碼consigneeOrgIDstringC收貨人在區(qū)塊鏈的組織代碼

船公司代理組織

1.3.62shipAgentOrgIDstringC船公司代理在區(qū)塊鏈的組織代碼

代碼

20信息明細(xì)assetContentobjectM所需創(chuàng)建的信息明細(xì)

6.2.4返回內(nèi)容

返回內(nèi)容的數(shù)據(jù)格式和要求應(yīng)符合表5的規(guī)定。

表5信息創(chuàng)建返回內(nèi)容數(shù)據(jù)格式要求

序號層次中文名稱英文名稱類型是否必填說明

10代碼codestringM由區(qū)塊鏈返回的回執(zhí)代碼

20錯誤簡要描述errorstringC1000000：表示成功；

30回執(zhí)明細(xì)dataobjectM其余代碼：表示出錯

由區(qū)塊鏈返回。如果有錯誤，則會返

3.11事務(wù)識別號txnIDstringC

回錯誤簡要描述

由區(qū)塊鏈返回的回執(zhí)明細(xì)。如果有報

3.21信息識別碼assetIDstringC

錯，則會返回錯誤明細(xì)

如果成功，由區(qū)塊鏈返回的唯一事務(wù)

3.31錯誤列表detailsarrayC

識別號

如果成功，由區(qū)塊鏈返回的唯一上鏈

3.3.12錯誤明細(xì)messagestringC

信息識別碼

3.3.22錯誤類型typestringC如果錯誤，由區(qū)塊鏈返回的錯誤列表

信息更新接口

6.3.1接口說明

根據(jù)業(yè)務(wù)應(yīng)用需要，依據(jù)信息識別碼和信息版本號，更新之前已經(jīng)創(chuàng)建過的信息，以新版本進(jìn)行上

鏈。如需撤回之前已經(jīng)創(chuàng)建過的信息，可在上鏈信息的assestcontent中標(biāo)記“撤回”。

6.3.2請求內(nèi)容

信息更新接口的請求頭信息數(shù)據(jù)格式和要求應(yīng)符合表6的規(guī)定。

6

JT/TXXXXX—XXXX

表6信息更新請求頭信息數(shù)據(jù)格式要求

序號中文名稱英文名稱類型是否必填說明

信息更新方區(qū)塊鏈組織代碼，在區(qū)塊

1區(qū)塊鏈組織代碼orgIDstringM鏈注冊后，由區(qū)塊鏈創(chuàng)建的唯一的組

織代碼

2角色rolestringM信息更新方

區(qū)塊鏈業(yè)務(wù)應(yīng)用場景編區(qū)塊鏈針對業(yè)務(wù)應(yīng)用場景分配的編

3applicationIDstringM

號號

4信息識別碼assetIDstringM唯一信息識別碼

5信息版本assetVersionstringM當(dāng)前區(qū)塊鏈上該信息的版本

6.3.3上鏈內(nèi)容

信息更新上鏈內(nèi)容數(shù)據(jù)格式要求應(yīng)符合表7的規(guī)定。

表7信息更新上鏈內(nèi)容數(shù)據(jù)格式要求

序號層次中文名稱英文名稱類型是否必填說明

信息更新方指定允許查詢的參與方

10角色清單roleListobjectM

清單

roleListLocator采集信息，供區(qū)塊鏈生成唯一上鏈信

1.11角色清單定位鍵objectM

Key息識別碼

1.1.12承運(yùn)人代碼carrierScacstringM承運(yùn)人scac代碼

1.1.22提單號blNumberstringC提單號

1.1.32提貨單號doNumberstringC提貨單號

1.1.42集裝箱號cntrNumberstringC集裝箱號

1.1.52角色清單類型roleListTypestringM角色清單類型。如：SEAWAY_BILL

1.21角色清單類型roleListTypestringM角色清單類型。如：SEAWAY_BILL

1.31角色清單內(nèi)容roleListContentobjectM參與方清單內(nèi)容

1.3.12承運(yùn)人組織代碼carrierOrgIDstringC承運(yùn)人在區(qū)塊鏈的組織代碼

最終卸港碼頭組lastPodTerminal

1.3.22stringC最終卸港碼頭在區(qū)塊鏈的組織代碼

織代碼OperatorOrgID

1.3.32托運(yùn)人組織代碼shipperOrgIDstringC托運(yùn)人在區(qū)塊鏈的組織代碼

貨運(yùn)代理組織代

1.3.42forwardeOrgIDstringC貨運(yùn)代理在區(qū)塊鏈的組織代碼

碼

1.3.52收貨人組織代碼consigneeOrgIDstringC收貨人在區(qū)塊鏈的組織代碼

船公司代理組織

1.3.62shipAgentOrgIDstringC船公司代理在區(qū)塊鏈的組織代碼

代碼

1.41信息明細(xì)assetContentobjectM所需更新的信息明細(xì)

6.3.4返回內(nèi)容

返回內(nèi)容應(yīng)符合6.2.4的規(guī)定。

信息推送接口

6.4.1接口說明

消息上鏈成功之后，平臺將消息推送給該消息角色清單中的參與方。

6.4.2請求內(nèi)容

信息推送請求頭信息數(shù)據(jù)格式要求應(yīng)符合表8的規(guī)定。

7

JT/TXXXXX—XXXX

表8信息推送請求頭信息數(shù)據(jù)格式要求

序號中文名稱英文名稱類型是否必填說明

參與方在區(qū)塊鏈注冊時，提供給區(qū)塊

1授權(quán)碼authorizationstringM鏈，用來接收信息推送接口的授權(quán)

碼，是數(shù)據(jù)交互安全的手段之一

6.4.3上鏈內(nèi)容

信息推送上鏈內(nèi)容數(shù)據(jù)格式要求應(yīng)符合表9的規(guī)定。

表9信息推送上鏈內(nèi)容數(shù)據(jù)格式要求

序號層次中文名稱英文名稱類型是否必填說明

10信息識別碼assetIDstringM信息推送所對應(yīng)的唯一信息識別碼

20信息版本assetVersionstringM由區(qū)塊鏈返回的當(dāng)前信息版本

返回由區(qū)塊鏈預(yù)先定義的信息類型，

每種信息均有定義的專屬信息類型。

30信息類型assetTypestringM

區(qū)塊鏈用此信息類型定義，控制信息

中具體數(shù)據(jù)項的訪問權(quán)限

由區(qū)塊鏈產(chǎn)生的數(shù)字指紋，用來追蹤

40數(shù)字指紋locatorKeystringM

相關(guān)參與方

由區(qū)塊鏈返回的上鏈?zhǔn)聞?wù)識別號和

50上鏈?zhǔn)聞?wù)onchainTxnsarrayM

時間戳

由區(qū)塊鏈返回的區(qū)塊鏈通道信息，一

5.11區(qū)塊鏈通道channelstringM

個通道對應(yīng)一本區(qū)塊鏈分布式賬本

5.21事務(wù)識別號txnIDstringM由區(qū)塊鏈返回的唯一事務(wù)識別號

5.31參與方participantsarrayM由區(qū)塊鏈返回的參與方清單

由區(qū)塊鏈返回的上鏈時的時間戳，采

5.41時間戳timestampstringM

用格林威治時間

信息在平臺創(chuàng)建的時間戳，采用格林

60創(chuàng)建的時間戳createAtstringM

威治時間

信息在平臺更新的時間戳，采用格林

70更新的時間戳updateAtstringM

威治時間

80加密策略encryptStrategystringM由區(qū)塊鏈返回的加密策略

信息提供方的事由區(qū)塊鏈返回的信息提供方的數(shù)字

90payloadSignstringM

務(wù)數(shù)字簽名簽名

鏈上信息的哈希

100assetHashstringM由區(qū)塊鏈返回的鏈上信息哈希值

值

110信息明細(xì)assetContentobjectM由區(qū)塊鏈返回的信息明細(xì)

6.4.4返回內(nèi)容

信息推送接口的狀態(tài)應(yīng)由HTTP狀態(tài)碼進(jìn)行識別，HTTP狀態(tài)碼200為成功，其它狀態(tài)碼為失敗。

信息查詢接口

6.5.1接口說明

參與方可通過該接口查詢鏈上信息。

6.5.2請求內(nèi)容

信息查詢請求內(nèi)容數(shù)據(jù)格式要求應(yīng)符合表10的規(guī)定。

8

JT/TXXXXX—XXXX

表10信息查詢請求內(nèi)容數(shù)據(jù)格式要求

序號中文名稱英文名稱類型是否必填說明

信息查詢方區(qū)塊鏈組織代碼，在區(qū)塊

1區(qū)塊鏈組織代碼orgIDstringM鏈注冊后，由區(qū)塊鏈創(chuàng)建的唯一的組

織代碼

2角色rolestringM信息查詢方

區(qū)塊鏈業(yè)務(wù)應(yīng)用場景編區(qū)塊鏈針對業(yè)務(wù)應(yīng)用場景分配的編

3applicationIDstringM

號號

需要查詢信息所對應(yīng)的唯一信息識

4信息識別碼assetIDstringM

別碼

5信息版本assetVersionstringC當(dāng)前區(qū)塊鏈上該信息的版本

6.5.3返回內(nèi)容

信息查詢返回內(nèi)容數(shù)據(jù)格式要求應(yīng)符合表11的規(guī)定。

表11信息查詢返回內(nèi)容數(shù)據(jù)格式要求

序號層次中文名稱英文名稱類型是否必填說明

10代碼codestringM由區(qū)塊鏈返回的回執(zhí)代碼

20數(shù)據(jù)dataarrayM由區(qū)塊鏈返回的回執(zhí)明細(xì)

需要查詢信息所對應(yīng)的唯一信息識

2.11信息識別碼assetIDstringM

別碼

由區(qū)塊鏈返回的鏈上信息的當(dāng)前版

2.21信息版本assetVersionstringM

本

返回由區(qū)塊鏈預(yù)先定義的信息類型，

每種信息均有定義的專屬信息類型。

2.31信息類型assetTypestringM

區(qū)塊鏈用此信息類型定義，控制信息

中具體數(shù)據(jù)項的訪問權(quán)限

由區(qū)塊鏈產(chǎn)生的數(shù)字指紋，用來追蹤

2.41數(shù)字指紋locatorKeystringM

相關(guān)參與方

2.51數(shù)據(jù)報文散列值assetHashstringM由區(qū)塊鏈返回的資產(chǎn)散列值

提供方的事務(wù)數(shù)由區(qū)塊鏈返回的提供方的交易數(shù)字

2.61payloadSignstringM

字簽名簽名

2.71加密策略encryptStrategystringM由區(qū)塊鏈返回的加密策略

信息在平臺創(chuàng)建的時間戳，采用格林

2.81創(chuàng)建的時間戳createAtstringM

威治時間

信息在平臺更新的時間戳，采用格林

2.91更新的時間戳updateAtstringM

威治時間

由區(qū)塊鏈返回的上鏈?zhǔn)聞?wù)識別號和

2.101上鏈?zhǔn)聞?wù)onchainTxnsarrayM

時間戳

2.10.12事務(wù)識別號txnIDstringM由區(qū)塊鏈返回的唯一事務(wù)識別號

由區(qū)塊鏈返回的區(qū)塊鏈通道信息，一

2.10.22區(qū)塊鏈通道channelstringM

個通道對應(yīng)一本區(qū)塊鏈分布式賬本

2.10.32參與方participantsarrayM由區(qū)塊鏈返回的參與方清單

由區(qū)塊鏈返回的上鏈時的時間戳，

2.10.42時間戳timestampstringM

采用格林威治時間

2.111信息明細(xì)assetContentobjectM由區(qū)塊鏈返回的所查詢信息的明細(xì)

信息驗證接口

6.6.1接口說明

各參與方通過鏈上信息與鏈下信息的對比，來驗證鏈下信息是否有篡改。

6.6.2請求內(nèi)容

9

JT/TXXXXX—XXXX

信息驗證請求內(nèi)容數(shù)據(jù)格式要求應(yīng)符合表12的規(guī)定。

表12信息驗證請求內(nèi)容數(shù)據(jù)格式要求

序號中文名稱英文名稱類型是否必填說明

返回由區(qū)塊鏈預(yù)先定義的信息類型，

每種信息均有定義的專屬信息類型。

1信息類型assetTypestringM

區(qū)塊鏈用此信息類型定義，控制信息

中具體數(shù)據(jù)項的訪問權(quán)限

在區(qū)塊鏈注冊后，由區(qū)塊鏈創(chuàng)建的唯

2驗證方區(qū)塊鏈組織代碼orgIDstringM

一的組織代碼

信息驗證方在區(qū)塊鏈的角色（信息創(chuàng)

3角色rolestringM

建方、信息更新方或信息查詢方）

區(qū)塊鏈業(yè)務(wù)應(yīng)用場景編

4applicationIDstringM針對業(yè)務(wù)應(yīng)用場景分配的編號

號

需要查詢信息所對應(yīng)的唯一信息識

5信息識別碼assetIDstringM

別碼

6信息版本assetVersionstringM當(dāng)前區(qū)塊鏈上該信息的版本

6.6.3校驗內(nèi)容

信息驗證校驗內(nèi)容數(shù)據(jù)格式要求應(yīng)符合表13的規(guī)定。

表13信息驗證校驗內(nèi)容數(shù)據(jù)格式要求

序號中文名稱英文名稱類型是否必填說明

在區(qū)塊鏈注冊后，由區(qū)塊鏈創(chuàng)建的唯

1驗證方組織代碼originatorOrgIDstringM

一的組織代碼

2