T-SCA 019-2021 工業(yè)互聯(lián)網(wǎng)集裝箱二級節(jié)點平臺用戶接入與標識管理規(guī)范

55.180.10A

85 T/SCA

019—2021工業(yè)互聯(lián)網(wǎng)集裝箱二級節(jié)點平臺用戶接入與標識管理規(guī)范Specifications

of

subscriber

access

identification

level

node

platform

of

freight

發(fā)布

11-08

實施深圳市智能集裝箱技術(shù)協(xié)會 發(fā)

布T/SCA

019-2021 前言

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

11

范圍

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

12

規(guī)范性引用文件

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

13

術(shù)語和定義

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

14

用戶注冊

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

15

標識前綴申請

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

16

標識數(shù)據(jù)同步

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

27

數(shù)據(jù)交換格式

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

38

通信安全機制

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

9T/SCA

019-2021 本文件按照GB/T

1.1―《標準化工作導(dǎo)則

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

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

013 工業(yè)互聯(lián)網(wǎng)標識解析

集裝箱

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

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

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

等待二級節(jié)點系統(tǒng)管理員和頂級節(jié)點管理員審核；c）

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

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

部分修改：修改企業(yè)類型、機構(gòu)證件類型、統(tǒng)一社會信用代碼、所屬行業(yè)、注冊所在地、法人證件類型、法人姓名之外的信息，只需要二級節(jié)點管理員審核通過。6 標識數(shù)據(jù)同步6.1 標識創(chuàng)建用戶向集裝箱平臺發(fā)起標識創(chuàng)建動作，內(nèi)容包括標識、附加數(shù)據(jù)等，集裝箱平臺收到數(shù)據(jù)后，返回數(shù)據(jù)入庫成功或失敗狀態(tài)。6.2 標識修改用戶向集裝箱平臺發(fā)起標識修改動作，內(nèi)容包括標識、附加數(shù)據(jù)等，集裝箱平臺收到數(shù)據(jù)后，返回數(shù)據(jù)入庫成功或失敗狀態(tài)。標識附加數(shù)據(jù)是指一個集裝箱身份標識產(chǎn)生的各類業(yè)務(wù)數(shù)據(jù)，如位置、狀態(tài)、操作（生產(chǎn)下線、托運、報關(guān)、通關(guān)、堆場、裝船、卸船、船運、維修等）?？梢圆捎脴俗R修改方式，由用戶向集裝箱平臺發(fā)起標識附加數(shù)據(jù)上報動作，集裝箱平臺收到數(shù)據(jù)后，返回數(shù)據(jù)入庫成功或失敗狀態(tài)。6.3標識刪除

T/SCA

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

請求參數(shù)說明7.2.4表1

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

返回參數(shù)說明

T/SCA

019-2021

200,

"Success",

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

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

請求參數(shù)說明7.3.4表4

請求參數(shù)說明7.3.4 返回說明平臺返回下述數(shù)據(jù)包給調(diào)用端：{

"message":

{

},"success":

T/SCA

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

請求參數(shù)說明7.4.4表5

請求參數(shù)說明7.4.4返回說明{

T/SCA

019-2021"message":

"success":

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

請求參數(shù)說明7.5.4表6

請求參數(shù)說明7.5.4返回說明

200,

"Success",

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

請求參數(shù)說明

T/SCA

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

"message":

"success":

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

請求參數(shù)說明7.7.4表8

請求參數(shù)說明7.7.4 返回說明

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

T/SCA

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

請求參數(shù)說明7.8.4表9

請求參數(shù)說明7.8.4返回說明{

"message":

data:[里面放多條業(yè)務(wù)數(shù)據(jù),格式不限制]"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