TSDZDH 004-2021設計技術規(guī)范

ICS35.040

A24

T/SDZDH

團體標準

T/SDZDH004—2021

工業(yè)互聯網標識解析儀器儀表應用服務

平臺接口規(guī)范

IdentificationandResolutionOfIndustrialInternet-ApplicationServicePlatform

InterfaceofInstrument

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

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

T/SDZDH004-2021

目次

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

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

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

3術語和定義.............................................................................1

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

5接口設計原則..........................................................................2

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

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

6.2數據類接口........................................................................3

6.3服務類接口........................................................................3

6.4應用類接口........................................................................3

7接口技術要求..........................................................................4

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

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

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

參考文獻...........................................................................6

I

T/SDZDH004-2021

_*_Z__1—

刖R

本文件按照GB/T1.1—2020《標準化工作導則第1部分：標準化文件的結構和起草規(guī)則》的規(guī)定起

草。

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

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

新一代標準化研究院有限公司、中國科學院沈陽自動化研究所、中國信息通信研究院、浙江中控自動化儀表

有限公司、山東省計量科學研究院、濟南市水文中心、山東省調水工程運行維護中心、重慶川儀自動化股份有

限公司、青島市計量技術研究院、重慶市計量質量檢測研究院、濟南金鐘電子衡器股份有限公司、平度市檢驗檢

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

大學、濟南熱力集團有限公司、濟南瑞泉電子有限公司、北京福通互聯科技集團有限公司、北京順鑫控股集團

有限公司、中國石油大學、數炬（山東）智能科技有限公司。

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

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

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

II

T/SDZDH004-2021

工業(yè)互聯網標識解析儀器儀表應用服務平臺接口規(guī)范

1范圍

本文件規(guī)定了在工業(yè)互聯網標識解析中的儀器儀表應用服務平臺接口設計原則、接口分類要求、接口

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

本部分適用于工業(yè)互聯網標識解析應用服務能力建設及應用。

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

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

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

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

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

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

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

GB/T22239-2019信息安全技術網絡安全等級保護基本要求

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

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

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

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

JJF1001-2018通用計量術語及定義

3術語和定義

下列術語和定義適用于本文件。

3.1

令牌token

認證子系統(tǒng)產生的，用于標識用戶的登錄身份信息。

[ZH018-2019,定義3.4]

3.2

用戶user

使用或接受工業(yè)互聯網儀表平臺服務的自然人。

3.3

客戶customer

1

T/SDZDH004-2021

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

3.4

身份認證identityauthentication

包含實名核驗和登錄認證。實名核驗是對用戶身份進行實名核驗時的認證。

[ZH018-2019,定義3.2]

4縮略語

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

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

HypertextTransferProtocolSecure)

MQTT:消息隊列遙測傳輸協議(MessageQueuingTelemetryTransport)

AMQP:高級消息隊列協議(AdvancedMessageQueuingProtocol)

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

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

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

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

App:應用程序(Application)

CPU:中央處理器(CentralProcessingUnit)

5接口設計原則

接口設計的基本原則包括但不限于：

a)安全性：應提供多種安全可靠的技術手段，保證服務接口的安全；

b)開放性：應采用通用的接口設計標準，保證與其他系統(tǒng)的互聯互通；

c)靈活性：應能根據業(yè)務變化，靈活調整接口容量與性能；

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

6接口分類要求

工業(yè)互聯網標識解析儀器儀表應用服務平臺應對外提供安全類接口、數據類接口、服務類接口和應用

類接口以及標識類接口、事件類接口和運營類接口。儀器儀表應用服務平臺接口分類見圖1。

2

T/SDZDH004-2021

一

數

中

零

身

產

統(tǒng)

部

監(jiān)

權密

訂

測

公

客

標

分

服

據

間

部

份

計

署

控

鑰

購

量

共

戶

識

析

務

資

品

限

加

件

件

認

指

發(fā)

管

管

信

信

信

料

關

管

計

訂

信

管

信

接

解

類

證

標

布

理

息

息

息

理

系

理

算

閱

理

息

息

入

密

類

類

類

類

類

類

類

類

類

類

類

類

類

類

類

類

—

1—

T

標識類接口事件類接口運行類接口

工—

H

一

標

標

標標

消

報

儀

儀

識

識

識識

息

警

表

表

采

查

發(fā)管

事

事

狀

運

集

詢

現理

件

件

態(tài)

行

類

類

類類

類

類

類

類

圖1儀器儀表應用服務平臺接口分類

6.1安全類接口

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

a）身份認證類：應包含用戶認證（用戶名/密碼、手機短信、第三方認證）、接口API認證等接

口；

b）權限管理類：應包含獲取權限、授予權限、刪除權限等接口；

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

d）數據加解密類：應包含數據加密、數據解密等接口。

6.2數據類接口

數據類接口包含但不限于以下類型：

—客戶信息類：包含獲取用戶資料信息、獲取客戶資料信息、獲取用戶認證信息、獲取客戶認證信息、

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

一產品信息類：包含獲取儀器儀表基本信息、獲取儀器儀表詳細信息、儀器儀表分類信息、獲取儀器

儀表評價信息等接口；

一零部件信息類：包含獲取產品零件信息、獲取產品部件信息、獲取產品原材料信息、獲取零部件分

類信息等接口；

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

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

一測量信息類：包含獲取儀器儀表測點信息、獲取儀器儀表設備信息、獲取儀器儀表位置信息、、

獲取企業(yè)網關信息、獲取采集點信息等接口；

——統(tǒng)計指標類：包含獲取標識注冊量信息、獲取測量數據報送指標信息、獲取服務使用記錄統(tǒng)計

3

T/SDZDH004-2021

信息等接口；

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

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

6.3服務類接口

服務類接口包含但不限于以下類型：

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

服務提供商信息變更服務等接口；

b）標識管理類：包含標識注冊服務、標識編碼服務、標識賦碼服務、標識溯源服務等接口；

c）分析計算類：包含客戶分析評價服務、產品分析評價服務、儀器儀表測量類數據分析服務、儀器儀

表全周期視圖等接口；

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

服務等接口；

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

數據存儲服務、數據處理服務等接口。

f）財務類：實現服務結算及財務信息傳遞的接口。

6.4應用類接口

應用類接口包含但不限于以下類型：

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

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

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

務實例狀態(tài)等接口；

c）監(jiān)控管理類：包含查看應用流量、查看應用訪問量、查看應用CPU、查看應用內存、監(jiān)控報警

設置等接口。

6.5標識類接口

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

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

記業(yè)務。

標識查詢類接口接受標識解析的請求指令，給出儀表產品在制造、銷售、檢驗、使用和計量、管理過

程中產生的數據。

標識發(fā)現類接口完成根據指定條件查詢相關的工業(yè)互聯網標識解析信息服務訪問入口信息的功能，

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

6.6事件類接口

事件類應包含：消息事件類、報警事件類等接口；其中：

儀表消息事件類包含：編碼事件、生產事件、調試事件、流通事件、安裝事件、檢校事件、維修事件和

報廢事件等。

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

6.7運行類接口

運行類應包含儀表狀態(tài)類、儀表運行數據等類型接口；其中:

4

T/SDZDH004-2021

儀表狀態(tài)類包含：儀表運行時間、獲取儀表當前計量、檢驗狀態(tài)等接口。

儀表運行類包含：儀表運行數據采集等接口。

7接口技術要求

接口技術要求包括但不限于：

a）接口傳輸協議：應支持HTTPS、MQTT、和AMQP等協議中的一種或多種；

b）