55.180.10A

85 T/SCA

019—2021工業互聯網集裝箱二級節點平臺用戶接入與標識管理規范Specifications

of

subscriber

access

identification

level

node

platform

of

freight

發布

11-08

實施深圳市智能集裝箱技術協會 發

布T/SCA

019-2021 前言

.................................................................................

11

范圍

..............................................................................

12

規范性引用文件

....................................................................

13

術語和定義

........................................................................

14

用戶注冊

..........................................................................

15

標識前綴申請

......................................................................

16

標識數據同步

......................................................................

27

數據交換格式

......................................................................

38

通信安全機制

......................................................................

9T/SCA

019-2021 本文件按照GB/T

1.1―《標準化工作導則

第1部分：標準化文件的結構和起草規則》的規定起草。請注意本文件的某些內容可能涉及專利。本文件的發布機構不承擔識別專利的責任。本文件由深圳市智能集裝箱技術協會提出和歸口。所、上海理想信息產業（集團）有限公司、廈門衛星定位應用股份有限公司。本文件主要起草人：周受欽、劉浩、李繼春、李媛紅、權進國、易曉珊、張曙光、盛駿、張旭杰、楊小明、廖星星、呂潔印、李大命、文常強、江培舟、李志揚、李佳駿、陳雷。T/SCA

019-20211 范圍換格式和通信安全機制。本文件適用于工業互聯網集裝箱二級節點平臺的用戶接入與標識管理。2 規范性引用文件凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。T/SCA

013 工業互聯網標識解析

集裝箱

標識編碼規范3 術語和定義下列術語和定義適用于本文件。3.1集裝箱身份標識UTF-8/項為可選，用于唯一識別標識對象。3.2工業互聯網集裝箱二級節點平臺4 用戶注冊手機號等信息。5標識前綴申請5.1申請標識前綴T/SCA

019-2021用戶應在集裝箱平臺在線申請集裝箱身份標識前綴。申請流程如下：a）

申請者如實填寫企業信息，具體包括： 企業名稱企業類型 機構證件類型 證件照片統一社會信用代碼 所屬行業 注冊所在地 法人姓名 法人證件類型 法人證件號碼 聯系人姓名 聯系人手機 聯系人郵箱 聯系人身份證b）

等待二級節點系統管理員和頂級節點管理員審核；c）

審核通過后，獲得標識。5.2信息變更息變更包括以下兩類：a）

全量修改：修改企業類型、機構證件類型、統一社會信用代碼、所屬行業、注冊所在地、法人證件類型、法人姓名，需要二級節點管理員和頂級節點管理員審核通過；b）

部分修改：修改企業類型、機構證件類型、統一社會信用代碼、所屬行業、注冊所在地、法人證件類型、法人姓名之外的信息，只需要二級節點管理員審核通過。6 標識數據同步6.1 標識創建用戶向集裝箱平臺發起標識創建動作，內容包括標識、附加數據等，集裝箱平臺收到數據后，返回數據入庫成功或失敗狀態。6.2 標識修改用戶向集裝箱平臺發起標識修改動作，內容包括標識、附加數據等，集裝箱平臺收到數據后，返回數據入庫成功或失敗狀態。標識附加數據是指一個集裝箱身份標識產生的各類業務數據，如位置、狀態、操作（生產下線、托運、報關、通關、堆場、裝船、卸船、船運、維修等）。可以采用標識修改方式，由用戶向集裝箱平臺發起標識附加數據上報動作，集裝箱平臺收到數據后，返回數據入庫成功或失敗狀態。6.3標識刪除

T/SCA

019-2021用戶向集裝箱平臺發起標識刪除動作，內容包括標識、附加數據等，集裝箱平臺收到數據后，返回數據入庫成功或失敗狀態。6.4 標識檢索7數據交換格式7.1 數據格式定義用戶應用系統與集裝箱平臺之間的數據交互采用協議，返回數據格式為，消息總長度應不超過字節。7.2用戶注冊7.2.1 接口調用地址接口調用地址為：user/register。7.2.2 請求方式采用HTTP/HTTPS協議的請求方式。7.2.3 請求參數說明POST請求參數如表1所示。表1

請求參數說明7.2.4表1

請求參數說明7.2.4 返回說明平臺以JSON數據包返回參數信息。參數說明如表2所示。表2表2

返回參數說明

T/SCA

019-2021

200,

"Success",

true 錯誤情況平臺以JSON數據包返回錯誤碼等信息，錯誤碼說明如表3所示。表3表3

錯誤碼說明{"errcode":500,"message":""}7.3 用戶登錄7.3.1 接口調用地址接口調用地址為：。7.3.2 請求方式采用HTTP/HTTPS協議的請求方式。7.3.3 請求參數說明POST請求參數如表4所示。表4

請求參數說明7.3.4表4

請求參數說明7.3.4 返回說明平臺返回下述數據包給調用端：{

"message":

{

},"success":

T/SCA

019-2021}錯誤情況平臺以JSON數據包返回錯誤碼等信息。{"errcode":500,"message":""}7.4 企業標識前綴申請7.4.1接口調用地址接口調用地址為：enterprise/enroll。7.4.2請求方式采用HTTP/HTTPS協議的請求方式。7.4.3 請求參數說明POST請求參數如表5所示。表5

請求參數說明7.4.4表5

請求參數說明7.4.4返回說明{

T/SCA

019-2021"message":

"success":

}7.5 標識新增7.5.1 接口調用地址接口調用地址為：containernode/insert。7.5.2 請求方式采用HTTP/HTTPS協議的請求方式。7.5.3請求參數說明POST請求參數如表6所示。表6

請求參數說明7.5.4表6

請求參數說明7.5.4返回說明

200,

"Success",

true7.6標識修改7.6.1 接口調用地址接口調用地址為：containernode/update。7.6.2 請求方式采用HTTP/HTTPS協議的請求方式。7.6.3請求參數說明POST請求參數如表7所示。表7表7

請求參數說明

T/SCA

019-20217.6.4返回說明正常情況下，平臺返回下述7.6.4返回說明{

"message":

"success":

}7.7標識刪除7.7.1 接口調用地址接口調用地址為：containernode/delete。7.7.2 請求方式采用HTTP/HTTPS協議的請求方式。7.7.3 請求參數說明POST請求參數如表8所示。表8

請求參數說明7.7.4表8

請求參數說明7.7.4 返回說明

7.8標識檢索7.8.1 接口調用地址接口調用地址為：containernode/searchContainer。7.8.2 請求方式

T/SCA

019-2021采用HTTP/HTTPS協議的請求方式。7.8.3請求參數說明POST請求參數如表9所示。表9

請求參數說明7.8.4表9

請求參數說明7.8.4返回說明{

"message":

data:[里面放多條業務數據,格式不限制]"success":

}"data":["boxNo":"SEGU9431435","manufacturerNo":"QCRC","manufacturingCountry":null,"inspectionDate":"2021-04-17

"updateUser":null,T/SCA

019-2021"updateTime":null,"identityRetrievalAddress":"","handle":"88.126.1/PRD.CONT.41RST.SEGU9431435","handle2":"88.126.1/PRD.CONT.41RST.SEGU9431435","latitude":22.4925530000000009067662176676094532012939453125,"longitude":113.876855000000006157279131002724170684814