《安全閥產(chǎn)品追溯 第三部分：數(shù)據(jù)交換與傳輸接口技術(shù)要求》

ICS13.240

CCSU52

中國(guó)特種設(shè)備安全與節(jié)能促進(jìn)會(huì)標(biāo)準(zhǔn)

CPASEPXXX-XXXX

安全閥產(chǎn)品追溯

第3部分：數(shù)據(jù)交換與傳輸接口技術(shù)要求

Safetyvalveproducttraceability—Part3：InformationTechnicalrequirementsfor

dataexchangeandtransmissioninterface

（征求意見(jiàn)稿）

××××-××-××發(fā)布××××-××-××實(shí)施

中國(guó)特種設(shè)備安全與節(jié)能促進(jìn)會(huì)發(fā)布

CPASEP×××—××××

安全閥產(chǎn)品追溯

第3部分：數(shù)據(jù)交換與傳輸接口技術(shù)要求

1范圍

1.1本文件主要規(guī)定了企業(yè)級(jí)安全閥信息系統(tǒng)與省級(jí)（市級(jí)）監(jiān)察信息系統(tǒng)、國(guó)家級(jí)監(jiān)管平臺(tái)的數(shù)據(jù)交

換關(guān)系，數(shù)據(jù)交換要求、接口技術(shù)要求和數(shù)據(jù)安全要求等內(nèi)容。

1.2本文件適用于安全閥追溯數(shù)據(jù)的采集、交換及接口設(shè)計(jì)和開(kāi)發(fā)。

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

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

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

用于本文件。

安全閥產(chǎn)品追溯第1部分：編碼與標(biāo)識(shí)規(guī)則

安全閥產(chǎn)品追溯第2部分：數(shù)據(jù)元規(guī)范

IETFRFC2616超文本傳輸協(xié)議-HTTP/1.1

IETFRFC5246傳輸層安全協(xié)議-1.2版

3術(shù)語(yǔ)和定義

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

3.1

企業(yè)級(jí)安全閥信息系統(tǒng)enterprisesafetyvalveinformationsystem

按照規(guī)定的數(shù)據(jù)格式和數(shù)據(jù)接口，為安全閥產(chǎn)品追溯提供數(shù)據(jù)的企業(yè)信息系統(tǒng)。企業(yè)包括安全閥生

產(chǎn)單位、使用單位及校驗(yàn)機(jī)構(gòu)。

3.2

省級(jí)（市級(jí)）監(jiān)察信息系統(tǒng)province（municipal）supervisionandinformationsystem

省級(jí)（市級(jí)）監(jiān)察信息系統(tǒng)，按照規(guī)定的數(shù)據(jù)格式和數(shù)據(jù)接口，從企業(yè)級(jí)安全閥信息系統(tǒng)（制造單

位信息系統(tǒng)、使用單位信息系統(tǒng)、檢測(cè)機(jī)構(gòu)信息系統(tǒng)）獲取數(shù)據(jù)的省級(jí)（市級(jí)）監(jiān)察相關(guān)的信息系統(tǒng)。

3.3

國(guó)家級(jí)監(jiān)管平臺(tái)statesupervisionandinformationsystem

1

CPASEP×××—××××

國(guó)家級(jí)監(jiān)管平臺(tái)，按照規(guī)定的數(shù)據(jù)格式和數(shù)據(jù)接口，從省級(jí)（市級(jí)）監(jiān)察信息系統(tǒng)獲取數(shù)據(jù)的國(guó)家

級(jí)信息系統(tǒng)。

4縮略語(yǔ)

下列縮略語(yǔ)適用于本文件：

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

HTTPS：安全超文本傳輸協(xié)議（SecureHyperTextTransferProtocol）

TLS：傳輸層安全性協(xié)議（TransportLayerSecurity）

JSON：輕量級(jí)的數(shù)據(jù)交換格式（JavaScriptObjectNotation）

5數(shù)據(jù)交換關(guān)系

企業(yè)級(jí)安全閥信息系統(tǒng)、省級(jí)（市級(jí)）監(jiān)察系統(tǒng)、國(guó)家級(jí)監(jiān)管平臺(tái)的數(shù)據(jù)交換關(guān)系見(jiàn)圖1,各系統(tǒng)

間數(shù)據(jù)交換信息類(lèi)別應(yīng)滿足《安全閥產(chǎn)品追溯第2部分：數(shù)據(jù)元規(guī)范》的要求。

圖1安全閥數(shù)據(jù)交換關(guān)系

6數(shù)據(jù)交換要求

6.1企業(yè)級(jí)安全閥信息系統(tǒng)

企業(yè)級(jí)安全閥信息系統(tǒng)（生產(chǎn)單位、使用單位、校驗(yàn)機(jī)構(gòu)）基于各方業(yè)務(wù)關(guān)系通過(guò)數(shù)據(jù)接口獲取如

下信息：

a）安全閥產(chǎn)品追溯信息：包括產(chǎn)品出廠編號(hào)、安全閥代碼、安全閥型號(hào)、安全閥位號(hào)、安全閥類(lèi)

型、進(jìn)口公稱(chēng)壓力、進(jìn)口公稱(chēng)尺寸、整定壓力、冷態(tài)試驗(yàn)差壓力、介質(zhì)類(lèi)型、密封中徑、閥體材料、生

2

CPASEP×××—××××

產(chǎn)日期；

b）安全閥生產(chǎn)單位基礎(chǔ)信息：包括生產(chǎn)單位或進(jìn)口代理商名稱(chēng)、統(tǒng)一社會(huì)信用代碼、注冊(cè)地址、

通訊地址、生產(chǎn)許可證編號(hào)、許可項(xiàng)目、有效期至；

c）安全閥使用管理追溯信息：包括設(shè)備種類(lèi)、設(shè)備注冊(cè)代碼、設(shè)備使用登記證編號(hào)、安全閥安裝

位置、設(shè)備工作壓力、要求整定壓力、工作溫度、工作介質(zhì)、校驗(yàn)狀態(tài)、安全閥狀態(tài)；

d）安全閥使用單位基礎(chǔ)信息：包括使用單位名稱(chēng)、統(tǒng)一社會(huì)信用代碼、注冊(cè)地址、通信地址；

e）安全閥校驗(yàn)追溯信息：包括校驗(yàn)記錄編號(hào)、校驗(yàn)日期、校驗(yàn)方式、整定壓力范圍、校驗(yàn)報(bào)告編

號(hào)、報(bào)告出具日期、下次校驗(yàn)日期、校驗(yàn)結(jié)果；

f）安全閥校驗(yàn)機(jī)構(gòu)基礎(chǔ)信息：校驗(yàn)機(jī)構(gòu)名稱(chēng)、統(tǒng)一社會(huì)信用代碼、注冊(cè)地址、通信地址、校驗(yàn)機(jī)

構(gòu)核準(zhǔn)證編號(hào)、許可項(xiàng)目、有效期至。

上述信息可以添加、修改和撤銷(xiāo)。

6.2省級(jí)（市級(jí)）監(jiān)察系統(tǒng)

省級(jí)（市級(jí)）監(jiān)察系統(tǒng)有權(quán)限通過(guò)數(shù)據(jù)接口從企業(yè)級(jí)安全閥信息系統(tǒng)獲取屬于本區(qū)域如下安全閥信

息：

a)安全閥產(chǎn)品追溯信息：包括產(chǎn)品出廠編號(hào)、安全閥代碼、安全閥型號(hào)、安全閥位號(hào)、安全閥類(lèi)

型、進(jìn)口公稱(chēng)壓力、進(jìn)口公稱(chēng)尺寸、整定壓力、冷態(tài)試驗(yàn)差壓力、介質(zhì)類(lèi)型、閥體材料、生產(chǎn)日期；

b)安全閥生產(chǎn)單位基礎(chǔ)信息：包括生產(chǎn)單位或進(jìn)口代理商名稱(chēng)、統(tǒng)一社會(huì)信用代碼、注冊(cè)地址、

通訊地址、生產(chǎn)許可證編號(hào)、許可項(xiàng)目、有效期至；

c)安全閥使用管理追溯信息包括設(shè)備種類(lèi)、設(shè)備注冊(cè)代碼、設(shè)備使用登記證編號(hào)、安全閥安裝位

置、設(shè)備工作壓力、要求整定壓力、工作溫度、工作介質(zhì)、校驗(yàn)狀態(tài)、安全閥狀態(tài)；

d)安全閥使用單位基礎(chǔ)信息：包括使用單位名稱(chēng)、統(tǒng)一社會(huì)信用代碼、注冊(cè)地址、通信地址；

e)安全閥校驗(yàn)追溯信息：包括校驗(yàn)記錄編號(hào)、校驗(yàn)日期、校驗(yàn)方式、整定壓力范圍、校驗(yàn)報(bào)告編

號(hào)、報(bào)告出具日期、下次校驗(yàn)日期、校驗(yàn)結(jié)果；

f)安全閥校驗(yàn)機(jī)構(gòu)基礎(chǔ)信息：校驗(yàn)機(jī)構(gòu)名稱(chēng)、統(tǒng)一社會(huì)信用代碼、注冊(cè)地址、通信地址、校驗(yàn)機(jī)

構(gòu)核準(zhǔn)證編號(hào)、許可項(xiàng)目、有效期至。

上述信息可以查閱。

6.3國(guó)家監(jiān)管平臺(tái)

國(guó)家監(jiān)管平臺(tái)有權(quán)限通過(guò)數(shù)據(jù)接口從省級(jí)（市級(jí)）監(jiān)察系統(tǒng)獲取全國(guó)范圍內(nèi)的如下安全閥信息：

a)安全閥產(chǎn)品追溯信息：包括產(chǎn)品出廠編號(hào)、安全閥代碼、安全閥型號(hào)、安全閥位號(hào)、安全閥類(lèi)

型、進(jìn)口公稱(chēng)壓力、進(jìn)口公稱(chēng)尺寸、整定壓力、冷態(tài)試驗(yàn)差壓力、介質(zhì)類(lèi)型、閥體材料、生產(chǎn)日期；

b)安全閥生產(chǎn)單位基礎(chǔ)信息：包括生產(chǎn)單位或進(jìn)口代理商名稱(chēng)、統(tǒng)一社會(huì)信用代碼、注冊(cè)地址、

通訊地址、生產(chǎn)許可證編號(hào)、許可項(xiàng)目、有效期至；

c)安全閥使用管理追溯信息：包括設(shè)備種類(lèi)、設(shè)備注冊(cè)代碼、設(shè)備使用登記證編號(hào)、安全閥安裝

位置、設(shè)備工作壓力、要求整定壓力、工作溫度、工作介質(zhì)、校驗(yàn)狀態(tài)、安全閥狀態(tài)；

d)安全閥使用單位基礎(chǔ)信息：包括使用單位名稱(chēng)、統(tǒng)一社會(huì)信用代碼、注冊(cè)地址、通信地址；

e)安全閥校驗(yàn)追溯信息：包括校驗(yàn)記錄編號(hào)、校驗(yàn)日期、校驗(yàn)方式、整定壓力范圍、校驗(yàn)報(bào)告編

號(hào)、報(bào)告出具日期、下次校驗(yàn)日期、校驗(yàn)結(jié)果；

f)安全閥校驗(yàn)機(jī)構(gòu)基礎(chǔ)信息：校驗(yàn)機(jī)構(gòu)名稱(chēng)、統(tǒng)一社會(huì)信用代碼、注冊(cè)地址、通信地址、校驗(yàn)機(jī)

構(gòu)核準(zhǔn)證編號(hào)、許可項(xiàng)目、有效期至。

上述信息可以查閱。

3

CPASEP×××—××××

6.4數(shù)據(jù)交換方式

安全閥數(shù)據(jù)交換與共享采用以下三種方式的一種:

a)網(wǎng)頁(yè)在線錄入方式:適用于沒(méi)有信息化系統(tǒng)支撐的、少量的數(shù)據(jù);

b)Excel模板數(shù)據(jù)導(dǎo)入方式:適用于沒(méi)有信息化系統(tǒng)支撐的、大批量的數(shù)據(jù);

c)跨語(yǔ)言和平臺(tái)的數(shù)據(jù)接口方式:適用于有信息化系統(tǒng)支撐的系統(tǒng)相互之間的數(shù)據(jù)交換與共享。

7接口技術(shù)要求

7.1數(shù)據(jù)接口開(kāi)發(fā)技術(shù)

數(shù)據(jù)交換應(yīng)遵循以下標(biāo)準(zhǔn),請(qǐng)求和響應(yīng)采用JSON格式，字符編碼統(tǒng)一采用UTF-8字符編碼，傳輸數(shù)

據(jù)采用數(shù)據(jù)簽名的方式進(jìn)行加密處理。

a)WebService調(diào)用

——傳輸標(biāo)準(zhǔn)：SOAP1.2；

——服務(wù)定義標(biāo)準(zhǔn)：采用標(biāo)準(zhǔn)的WEB服務(wù)說(shuō)明語(yǔ)言WSDL1.1；

——數(shù)據(jù)交換相關(guān)UDDI標(biāo)準(zhǔn)：采用標(biāo)準(zhǔn)的WEB服務(wù)說(shuō)明語(yǔ)言UDDI2.0。

b)RESTfulWebService調(diào)用

——傳輸標(biāo)準(zhǔn)：采用標(biāo)準(zhǔn)的傳輸協(xié)議HTTP/HTTPS1.1；

——服務(wù)定義標(biāo)準(zhǔn)：遵循RFC3986。

7.2數(shù)據(jù)接口功能

7.2.1接口基本功能

數(shù)據(jù)接口提供的功能包含數(shù)據(jù)新增、修改、刪除及數(shù)據(jù)查詢(xún)等功能；

a)數(shù)據(jù)新增：按時(shí)間戳增量上傳，包含數(shù)據(jù)的全量上傳；

b)數(shù)據(jù)修改：按接口數(shù)據(jù)元中的主鍵，進(jìn)行數(shù)據(jù)修改操作；

c)數(shù)據(jù)刪除：按數(shù)據(jù)元的主鍵，進(jìn)行數(shù)據(jù)刪除操作；

d)數(shù)據(jù)查詢(xún)：按數(shù)據(jù)元的主鍵等關(guān)鍵信息進(jìn)行數(shù)據(jù)查詢(xún)。

7.2.2數(shù)據(jù)校驗(yàn)功能

具備校驗(yàn)接口賬戶權(quán)限功能，能校驗(yàn)相應(yīng)數(shù)據(jù)調(diào)用、更新、刪除、查詢(xún)等數(shù)據(jù)操作權(quán)限;數(shù)據(jù)接口

能自動(dòng)讀取數(shù)據(jù)校驗(yàn)規(guī)則，進(jìn)行數(shù)據(jù)校驗(yàn)。

7.2.3接口監(jiān)控功能

提供有效的系統(tǒng)的可監(jiān)控機(jī)制，實(shí)時(shí)監(jiān)控接口的運(yùn)行情況，便于及時(shí)發(fā)現(xiàn)錯(cuò)誤、排除故障。

7.3數(shù)據(jù)接口技術(shù)格式

數(shù)據(jù)交換過(guò)程中數(shù)據(jù)的具體格式見(jiàn)附錄A。

7.4數(shù)據(jù)接口簽名規(guī)則

接口請(qǐng)求方和接口響應(yīng)方對(duì)所有的參數(shù)節(jié)點(diǎn)，使用鍵值對(duì)的格式key=value拼接字符串（鍵值對(duì)使

用&符號(hào)拼接），拼接字符串需要包含簽名私匙KEY值（“&key=簽名私鑰KEY”字符串），根據(jù)最終字

符串做MD5或SM4加密結(jié)果轉(zhuǎn)成大寫(xiě)，生成簽名串sign。

4

CPASEP×××—××××

7.5數(shù)據(jù)接口服務(wù)地址規(guī)則

數(shù)據(jù)接口服務(wù)地址規(guī)則：http://<ip>:<port>/<service>/<interFlag>或

https://<ip>:<port>/<service>/<interFlag>。其中：

a)ip表示服務(wù)提供者服務(wù)的ip地址或域名；

b)port表示服務(wù)提供者服務(wù)對(duì)應(yīng)的端口；

c)service表示接口服務(wù)提供者服務(wù)平臺(tái)的名稱(chēng)；

d)interFlag：表示服務(wù)提供者自定義的接口服務(wù)的名稱(chēng)。

8數(shù)據(jù)接口安全

8.1訪問(wèn)控制

傳輸數(shù)據(jù)文件中增加身份認(rèn)證消息報(bào)文，以實(shí)現(xiàn)對(duì)調(diào)用方的安全認(rèn)證；采用網(wǎng)頁(yè)錄入或者導(dǎo)入

方式的，則通過(guò)授予賬號(hào)登錄的方式，以確保數(shù)據(jù)的安全性；密碼可采用MD5、SM4等能夠保證安全級(jí)別

的加密方式進(jìn)行加密。

8.2數(shù)據(jù)交換量控制

在數(shù)據(jù)接口交換時(shí)，由數(shù)據(jù)交換雙方根據(jù)系統(tǒng)性能、物理帶寬等因素進(jìn)行數(shù)據(jù)交換量限制。

8.3數(shù)據(jù)重傳響應(yīng)機(jī)制

密碼校驗(yàn)失敗等原因造成的數(shù)據(jù)傳輸失敗3次的，應(yīng)進(jìn)行標(biāo)記，并按照一定時(shí)間再重新校驗(yàn)傳輸。

5

CPASEP×××—××××

附錄A消息結(jié)構(gòu)

（資料性）

A.1請(qǐng)求消息

A.1.1請(qǐng)求消息結(jié)構(gòu)

單條數(shù)據(jù)請(qǐng)求：

｛

"appid":"應(yīng)用賬號(hào)",

"busicode":"業(yè)務(wù)分類(lèi)代碼",

"action":"請(qǐng)求動(dòng)作代碼",

"busilist":

{

"id":"值",

"FIELD1":"值",

"FIELD2":"值",

"FIELD3":"值",

...

}，

"random":"請(qǐng)求隨機(jī)數(shù)",

"sign":"簽名數(shù)據(jù)"

｝

批量數(shù)據(jù)請(qǐng)求：

｛

"appid":"應(yīng)用賬號(hào)",

"busicode":"業(yè)務(wù)分類(lèi)代碼",

"action":"請(qǐng)求動(dòng)作代碼",

"busilist":[

{

"id":"值",

"FIELD1":"值",

"FIELD2":"值",

"FIELD3":"值",

...

},

{

"id":"值",

"FIELD1":"值",

"FIELD2":"值",

6

CPASEP×××—××××

"FIELD3":"值",

...

}

...

],

"random":"請(qǐng)求隨機(jī)數(shù)",

"sign":"簽名數(shù)據(jù)"

｝

A.1.2元素說(shuō)明

數(shù)據(jù)接口請(qǐng)求參數(shù)見(jiàn)表A.1。

表A.1數(shù)據(jù)接口請(qǐng)求參數(shù)

參數(shù)中文名稱(chēng)參數(shù)名類(lèi)型定義是否必填說(shuō)明

應(yīng)用賬號(hào)appid字符串是請(qǐng)求方應(yīng)用賬號(hào)，接口應(yīng)用雙方約定

業(yè)務(wù)分類(lèi)代碼busicode字符串是業(yè)務(wù)類(lèi)型代碼見(jiàn)表A.2

請(qǐng)求動(dòng)作代碼action字符串是請(qǐng)求動(dòng)作代碼見(jiàn)表A.3

各接口請(qǐng)求業(yè)務(wù)參數(shù)的內(nèi)容不同，實(shí)際內(nèi)容以各接口為準(zhǔn)；

請(qǐng)求業(yè)務(wù)參數(shù)busilist字符串是接口請(qǐng)求業(yè)務(wù)參數(shù)值，參數(shù)JSON格式，編碼字符集

UTF-8

每次請(qǐng)求生成一個(gè)唯一編號(hào)，全局唯一，宜采用UUID通

請(qǐng)求隨機(jī)標(biāo)識(shí)random字符串是

用唯一識(shí)別碼

簽名sign字符串是MD5或SM4加密轉(zhuǎn)換成大寫(xiě)

A.1.3業(yè)務(wù)分類(lèi)代碼

業(yè)務(wù)分類(lèi)代碼參見(jiàn)表A.2。

表A.2業(yè)務(wù)分類(lèi)代碼

業(yè)務(wù)分類(lèi)代碼類(lèi)型說(shuō)明

01安全閥產(chǎn)品追溯信息

02安全閥生產(chǎn)單位基礎(chǔ)信息

03安全閥使用管理追溯信息

04安全閥使用單位基礎(chǔ)信息

05安全閥校驗(yàn)追溯信息

06安全閥校驗(yàn)機(jī)構(gòu)基礎(chǔ)信息

7

CPASEP×××—××××

A.1.4請(qǐng)求動(dòng)作代碼

請(qǐng)求動(dòng)作代碼參見(jiàn)表A.3

表A.3請(qǐng)求動(dòng)作代碼

動(dòng)作代碼類(lèi)型說(shuō)明

01數(shù)據(jù)新增

02數(shù)據(jù)修改

03數(shù)據(jù)刪除

04數(shù)據(jù)查詢(xún)

A.2響應(yīng)消息

A.2.1響應(yīng)消息說(shuō)明

響應(yīng)消息的結(jié)構(gòu)說(shuō)明、屬性說(shuō)明應(yīng)如下。當(dāng)消息響應(yīng)不成功時(shí)，請(qǐng)求方重新發(fā)送數(shù)據(jù)。返回結(jié)果的

中的簽名規(guī)則與請(qǐng)求中簽名規(guī)則一致。

A.2.2響應(yīng)消息結(jié)構(gòu)

單條數(shù)據(jù)請(qǐng)求響應(yīng)：

｛

"appid":"應(yīng)用賬號(hào)",

"timestamp":"時(shí)間戳",

"busicode":"業(yè)務(wù)分類(lèi)代碼",

"datalist":{"result":"0001","message":"響應(yīng)業(yè)務(wù)結(jié)果描述",

"busilist":

{

"FIELD1":"值",

"FIELD2":"值",

"FIELD3":"值",

...

},

},

"random":"請(qǐng)求隨機(jī)數(shù)",

"sign":"簽名數(shù)據(jù)"

｝

批量數(shù)據(jù)請(qǐng)求響應(yīng)：

｛

"appid":"應(yīng)用賬號(hào)",

"timestamp":"時(shí)間戳",

"busicode":"業(yè)務(wù)分類(lèi)代碼",

8

CPASEP×××—××××

"datalist":{"result":"0001","message":"響應(yīng)業(yè)務(wù)結(jié)果描述",

"busilist":[

{

"FIELD1":"值",

"FIELD2":"值",

"FIELD3":"值",

...

},

{

"FIELD1":"值",

"FIELD2":"值",

"FIELD3":"值",

...

}

...

]

},

"random":"請(qǐng)求隨機(jī)數(shù)",

"sign":"簽名數(shù)據(jù)"

｝

A.2.3數(shù)據(jù)接口響應(yīng)說(shuō)明。

數(shù)據(jù)響應(yīng)參數(shù)說(shuō)明見(jiàn)表A.4

表A.4接口響應(yīng)參數(shù)

參數(shù)中文名稱(chēng)參數(shù)名類(lèi)型定義是否必填說(shuō)明

各API調(diào)用返回的內(nèi)容不同，實(shí)際內(nèi)容以各接口API為準(zhǔn)，

返回結(jié)果參數(shù)datalist字符串是

參數(shù)值為JSON格式，編碼字符集UTF-8

請(qǐng)求隨機(jī)標(biāo)識(shí)random字符串是對(duì)應(yīng)請(qǐng)求參數(shù)的random

簽名sign字符串是MD5或SM4加密轉(zhuǎn)換成大寫(xiě)

A.2.4返回結(jié)果datalist說(shuō)明

返回結(jié)果業(yè)務(wù)數(shù)據(jù)datalist分兩種情況：

a）請(qǐng)求成功時(shí)：

返回JSON格式如：{"result":"0001","message":"響應(yīng)業(yè)務(wù)結(jié)果描述",

"busil