TSDZDH 004-2021設(shè)計(jì)技術(shù)規(guī)范

ICS35.040

A24

T/SDZDH

團(tuán)體標(biāo)準(zhǔn)

T/SDZDH004—2021

工業(yè)互聯(lián)網(wǎng)標(biāo)識解析儀器儀表應(yīng)用服務(wù)

平臺接口規(guī)范

IdentificationandResolutionOfIndustrialInternet-ApplicationServicePlatform

InterfaceofInstrument

2021-09-30發(fā)布2021-09-30實(shí)施

山東省自動化學(xué)會發(fā)布

T/SDZDH004-2021

目次

前言.....................................................................................II

1范圍...................................................................................1

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

3術(shù)語和定義.............................................................................1

4縮略語.................................................................................2

5接口設(shè)計(jì)原則..........................................................................2

6接口分類要求..........................................................................2

6.1安全類接口........................................................................2

6.2數(shù)據(jù)類接口........................................................................3

6.3服務(wù)類接口........................................................................3

6.4應(yīng)用類接口........................................................................3

7接口技術(shù)要求..........................................................................4

8接口開發(fā)要求..........................................................................4

9接口使用要求..........................................................................4

10接口安全要求.........................................................................5

參考文獻(xiàn)...........................................................................6

I

T/SDZDH004-2021

_*_Z__1—

刖R

本文件按照GB/T1.1—2020《標(biāo)準(zhǔn)化工作導(dǎo)則第1部分：標(biāo)準(zhǔn)化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起

草。

本文件由山東省自動化學(xué)會提出并歸口。

本文件起草單位：濟(jì)南大陸機(jī)電股份有限公司、山東省計(jì)算中心（國家超級計(jì)算濟(jì)南中心）、山東

新一代標(biāo)準(zhǔn)化研究院有限公司、中國科學(xué)院沈陽自動化研究所、中國信息通信研究院、浙江中控自動化儀表

有限公司、山東省計(jì)量科學(xué)研究院、濟(jì)南市水文中心、山東省調(diào)水工程運(yùn)行維護(hù)中心、重慶川儀自動化股份有

限公司、青島市計(jì)量技術(shù)研究院、重慶市計(jì)量質(zhì)量檢測研究院、濟(jì)南金鐘電子衡器股份有限公司、平度市檢驗(yàn)檢

測中心、中國科學(xué)院沈陽自動化研究所、重慶儀表集團(tuán)有限公司、日照山川電子信息技術(shù)有限公司、北京科技

大學(xué)、濟(jì)南熱力集團(tuán)有限公司、濟(jì)南瑞泉電子有限公司、北京福通互聯(lián)科技集團(tuán)有限公司、北京順鑫控股集團(tuán)

有限公司、中國石油大學(xué)、數(shù)炬（山東）智能科技有限公司。

本文件件主要起草人：荊書典、史俊花、宋蘇林、楊揚(yáng)、傅爾權(quán)、張煒、高恒、張海濱、馬海峰、李

少敏、李明珊、車明圣、趙華、錢恒、李士波、朱本行、張鎮(zhèn)、李帆、尹旭、張旭、田娟、陳青峰、荊海

偉、潘崇超、姚杰、魯新光、羅林聰、范韶辰、劉陽、張?zhí)焓?、王剛、宋述古、于衛(wèi)國、李宜鵬。

II

T/SDZDH004-2021

工業(yè)互聯(lián)網(wǎng)標(biāo)識解析儀器儀表應(yīng)用服務(wù)平臺接口規(guī)范

1范圍

本文件規(guī)定了在工業(yè)互聯(lián)網(wǎng)標(biāo)識解析中的儀器儀表應(yīng)用服務(wù)平臺接口設(shè)計(jì)原則、接口分類要求、接口

技術(shù)、接口開發(fā)要求、接口使用要求和接口安全要求。

本部分適用于工業(yè)互聯(lián)網(wǎng)標(biāo)識解析應(yīng)用服務(wù)能力建設(shè)及應(yīng)用。

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

下列文件對于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅所注日期的版本適用于本文件。

凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。

下列文件對于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅所注日期的版本適用于本文件。

凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。

GB/T15843.3-2016信息技術(shù)安全技術(shù)實(shí)體鑒別第3部分：采用數(shù)字簽名技術(shù)的機(jī)制

GB/T15851.3-2018信息技術(shù)安全技術(shù)帶消息恢復(fù)的數(shù)字簽名方案第3部分：基于離散

GB/T22239-2019信息安全技術(shù)網(wǎng)絡(luò)安全等級保護(hù)基本要求

GB/T35273-2020信息安全技術(shù)個人信息安全規(guī)范

DB37/T3522—2019政務(wù)信息資源數(shù)據(jù)交換規(guī)范

DB37/T3523.2-2019公共數(shù)據(jù)開放第2部分：數(shù)據(jù)脫敏指南

ZH018-2019統(tǒng)一用戶管理及身份認(rèn)證平臺

JJF1001-2018通用計(jì)量術(shù)語及定義

3術(shù)語和定義

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

3.1

令牌token

認(rèn)證子系統(tǒng)產(chǎn)生的，用于標(biāo)識用戶的登錄身份信息。

[ZH018-2019,定義3.4]

3.2

用戶user

使用或接受工業(yè)互聯(lián)網(wǎng)儀表平臺服務(wù)的自然人。

3.3

客戶customer

1

T/SDZDH004-2021

完成工業(yè)互聯(lián)網(wǎng)儀表平臺注冊并通過審核后的法人主體。

3.4

身份認(rèn)證identityauthentication

包含實(shí)名核驗(yàn)和登錄認(rèn)證。實(shí)名核驗(yàn)是對用戶身份進(jìn)行實(shí)名核驗(yàn)時(shí)的認(rèn)證。

[ZH018-2019,定義3.2]

4縮略語

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

HTTPS:安全超文本傳輸協(xié)議(HyperTextTransferProtocoloverSecureSocketLayer或

HypertextTransferProtocolSecure)

MQTT:消息隊(duì)列遙測傳輸協(xié)議(MessageQueuingTelemetryTransport)

AMQP:高級消息隊(duì)列協(xié)議(AdvancedMessageQueuingProtocol)

URL:統(tǒng)一資源定位符(UniformResourceLocator)

API:應(yīng)用程序編程接口(ApplicationProgrammingInterface)

JSON:輕量級的數(shù)據(jù)交換格式(JavaScriptObjectNotation)

SDK:軟件開發(fā)工具包(SoftwareDevelopmentKit)

App:應(yīng)用程序(Application)

CPU:中央處理器(CentralProcessingUnit)

5接口設(shè)計(jì)原則

接口設(shè)計(jì)的基本原則包括但不限于：

a)安全性：應(yīng)提供多種安全可靠的技術(shù)手段，保證服務(wù)接口的安全；

b)開放性：應(yīng)采用通用的接口設(shè)計(jì)標(biāo)準(zhǔn)，保證與其他系統(tǒng)的互聯(lián)互通；

c)靈活性：應(yīng)能根據(jù)業(yè)務(wù)變化，靈活調(diào)整接口容量與性能；

d)松耦合：應(yīng)避免服務(wù)提供方的業(yè)務(wù)系統(tǒng)對服務(wù)接口實(shí)現(xiàn)的依賴性。

6接口分類要求

工業(yè)互聯(lián)網(wǎng)標(biāo)識解析儀器儀表應(yīng)用服務(wù)平臺應(yīng)對外提供安全類接口、數(shù)據(jù)類接口、服務(wù)類接口和應(yīng)用

類接口以及標(biāo)識類接口、事件類接口和運(yùn)營類接口。儀器儀表應(yīng)用服務(wù)平臺接口分類見圖1。

2

T/SDZDH004-2021

一

數(shù)

中

零

身

產(chǎn)

統(tǒng)

部

監(jiān)

權(quán)密

訂

測

公

客

標(biāo)

分

服

據(jù)

間

部

份

計(jì)

署

控

鑰

購

量

共

戶

識

析

務(wù)

資

品

限

加

件

件

認(rèn)

指

發(fā)

管

管

信

信

信

料

關(guān)

管

計(jì)

訂

信

管

信

接

解

類

證

標(biāo)

布

理

息

息

息

理

系

理

算

閱

理

息

息

入

密

類

類

類

類

類

類

類

類

類

類

類

類

類

類

類

類

—

1—

T

標(biāo)識類接口事件類接口運(yùn)行類接口

工—

H

一

標(biāo)

標(biāo)

標(biāo)標(biāo)

消

報(bào)

儀

儀

識

識

識識

息

警

表

表

采

查

發(fā)管

事

事

狀

運(yùn)

集

詢

現(xiàn)理

件

件

態(tài)

行

類

類

類類

類

類

類

類

圖1儀器儀表應(yīng)用服務(wù)平臺接口分類

6.1安全類接口

安全類接口包含但不限于以下類型：

a）身份認(rèn)證類：應(yīng)包含用戶認(rèn)證（用戶名/密碼、手機(jī)短信、第三方認(rèn)證）、接口API認(rèn)證等接

口；

b）權(quán)限管理類：應(yīng)包含獲取權(quán)限、授予權(quán)限、刪除權(quán)限等接口；

c）密鑰管理類：應(yīng)包含密鑰上傳、密鑰刪除等接口；

d）數(shù)據(jù)加解密類：應(yīng)包含數(shù)據(jù)加密、數(shù)據(jù)解密等接口。

6.2數(shù)據(jù)類接口

數(shù)據(jù)類接口包含但不限于以下類型：

—客戶信息類：包含獲取用戶資料信息、獲取客戶資料信息、獲取用戶認(rèn)證信息、獲取客戶認(rèn)證信息、

獲取APP認(rèn)證信息、獲取合作伙伴信息、會員信息、反饋信息等接口；

一產(chǎn)品信息類：包含獲取儀器儀表基本信息、獲取儀器儀表詳細(xì)信息、儀器儀表分類信息、獲取儀器

儀表評價(jià)信息等接口；

一零部件信息類：包含獲取產(chǎn)品零件信息、獲取產(chǎn)品部件信息、獲取產(chǎn)品原材料信息、獲取零部件分

類信息等接口；

—訂購信息類：包含獲取商品信息、獲取商品訂單信息、獲取賬單信息、獲取合約信息、獲取結(jié)算分

成信息、獲取積分信息等接口；

一測量信息類：包含獲取儀器儀表測點(diǎn)信息、獲取儀器儀表設(shè)備信息、獲取儀器儀表位置信息、、

獲取企業(yè)網(wǎng)關(guān)信息、獲取采集點(diǎn)信息等接口；

——統(tǒng)計(jì)指標(biāo)類：包含獲取標(biāo)識注冊量信息、獲取測量數(shù)據(jù)報(bào)送指標(biāo)信息、獲取服務(wù)使用記錄統(tǒng)計(jì)

3

T/SDZDH004-2021

信息等接口；

——公共信息類：包含獲取企業(yè)單位類型字典信息、獲取企業(yè)證件字典信息、獲取行政區(qū)劃編碼信息、

國家統(tǒng)計(jì)局行政管轄區(qū)信息等接口。

6.3服務(wù)類接口

服務(wù)類接口包含但不限于以下類型：

a）客戶關(guān)系類：包含用戶新增服務(wù)、企業(yè)信息注冊服務(wù)、企業(yè)信息變更服務(wù)、服務(wù)提供商注冊服務(wù)、

服務(wù)提供商信息變更服務(wù)等接口；

b）標(biāo)識管理類：包含標(biāo)識注冊服務(wù)、標(biāo)識編碼服務(wù)、標(biāo)識賦碼服務(wù)、標(biāo)識溯源服務(wù)等接口；

c）分析計(jì)算類：包含客戶分析評價(jià)服務(wù)、產(chǎn)品分析評價(jià)服務(wù)、儀器儀表測量類數(shù)據(jù)分析服務(wù)、儀器儀

表全周期視圖等接口；

d）服務(wù)訂閱類：包含服務(wù)訂閱服務(wù)、訂單支付服務(wù)、商品發(fā)布服務(wù)、服務(wù)授權(quán)、退單服務(wù)、訂單取消

服務(wù)等接口；

e）公共服務(wù)類：包含資源上傳下載服務(wù)、儀表分類更新服務(wù)、零部件分配服務(wù)、數(shù)據(jù)采集服務(wù)、

數(shù)據(jù)存儲服務(wù)、數(shù)據(jù)處理服務(wù)等接口。

f）財(cái)務(wù)類：實(shí)現(xiàn)服務(wù)結(jié)算及財(cái)務(wù)信息傳遞的接口。

6.4應(yīng)用類接口

應(yīng)用類接口包含但不限于以下類型：

a）應(yīng)用發(fā)布類：包含應(yīng)用創(chuàng)建、應(yīng)用上傳、服務(wù)綁定、服務(wù)解綁定、應(yīng)用啟動、應(yīng)用實(shí)例數(shù)設(shè)

置、應(yīng)用動態(tài)伸縮設(shè)置、應(yīng)用停止、獲取域名詳情、綁定域名、解綁域名、應(yīng)用銷毀等接口；

b）中間件接入類：包含服務(wù)接入、創(chuàng)建服務(wù)實(shí)例、服務(wù)實(shí)例配置、獲取環(huán)境變量、刪除服務(wù)實(shí)例、獲取服

務(wù)實(shí)例狀態(tài)等接口；

c）監(jiān)控管理類：包含查看應(yīng)用流量、查看應(yīng)用訪問量、查看應(yīng)用CPU、查看應(yīng)用內(nèi)存、監(jiān)控報(bào)警

設(shè)置等接口。

6.5標(biāo)識類接口

標(biāo)識類接口包含標(biāo)識采集類接口，標(biāo)識查詢類接口、標(biāo)識發(fā)現(xiàn)類接口、以及標(biāo)識管理類接口。

標(biāo)識采集注冊類接口完成儀表標(biāo)識代碼的生成、標(biāo)識數(shù)據(jù)的采集、以及向標(biāo)識解析節(jié)點(diǎn)發(fā)起的注冊登

記業(yè)務(wù)。

標(biāo)識查詢類接口接受標(biāo)識解析的請求指令，給出儀表產(chǎn)品在制造、銷售、檢驗(yàn)、使用和計(jì)量、管理過

程中產(chǎn)生的數(shù)據(jù)。

標(biāo)識發(fā)現(xiàn)類接口完成根據(jù)指定條件查詢相關(guān)的工業(yè)互聯(lián)網(wǎng)標(biāo)識解析信息服務(wù)訪問入口信息的功能，

標(biāo)識管理類接口完成標(biāo)識的更新、刪除以及備份等功能。

6.6事件類接口

事件類應(yīng)包含：消息事件類、報(bào)警事件類等接口；其中：

儀表消息事件類包含：編碼事件、生產(chǎn)事件、調(diào)試事件、流通事件、安裝事件、檢校事件、維修事件和

報(bào)廢事件等。

報(bào)警事件類包含：報(bào)警事件創(chuàng)建、報(bào)警事件設(shè)置、獲取報(bào)警事件、報(bào)警事件刪除、報(bào)警事件觸發(fā)等。

6.7運(yùn)行類接口

運(yùn)行類應(yīng)包含儀表狀態(tài)類、儀表運(yùn)行數(shù)據(jù)等類型接口；其中:

4

T/SDZDH004-2021

儀表狀態(tài)類包含：儀表運(yùn)行時(shí)間、獲取儀表當(dāng)前計(jì)量、檢驗(yàn)狀態(tài)等接口。

儀表運(yùn)行類包含：儀表運(yùn)行數(shù)據(jù)采集等接口。

7接口技術(shù)要求

接口技術(shù)要求包括但不限于：

a）接口傳輸協(xié)議：應(yīng)支持HTTPS、MQTT、和AMQP等協(xié)議中的一種或多種；

b）