T-SCA 018-2021 工業(yè)互聯(lián)網(wǎng)集裝箱二級節(jié)點平臺應用接口規(guī)范

55.180.10A

85 T/SCA

018—2021工業(yè)互聯(lián)網(wǎng)集裝箱二級節(jié)點平臺應用接口規(guī)范Application

interface

specification

secondary-level

node

platform

of

freightcontainer2021

–

10

-

08

發(fā)布

11-

08

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

布T/SCA

018-2021 前言

.................................................................................. Ⅰ1

范圍

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

12

規(guī)范性引用文件

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

13

術(shù)語和定義

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

14

系統(tǒng)對接流程與要求

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

15

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

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

26

通信安全機制

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

9T/SCA

018-2021 本文件按照GB/T

1.1―《標準化工作導則

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

018-20211范圍本文件規(guī)定了工業(yè)互聯(lián)網(wǎng)集裝箱二級節(jié)點平臺與第三方平臺之間數(shù)據(jù)通信的對接流程與要求、數(shù)據(jù)交換格式和通信安全機制。本文件適用于工業(yè)互聯(lián)網(wǎng)集裝箱二級節(jié)點平臺與第三方平臺之間的數(shù)據(jù)交換。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 對接流程與要求4.1 對接流程第三方平臺與集裝箱平臺之間的對接流程如下：a) 在集裝箱平臺進行賬號注冊；b) 利用已注冊的賬號、密碼登錄平臺，通過API接口獲取UserToken；c) 設(shè)置服務(wù)器的

地址或域名，通過

UserToken

請求名下集裝箱標識列表；d) 根據(jù)業(yè)務(wù)需求，選擇主動請求數(shù)據(jù)或被動接收數(shù)據(jù)。

T/SCA

018-20214.2 主動方式主動方式是指第三方平臺主動請求集裝箱平臺數(shù)據(jù)，包括：a) 通過UserToken和集裝箱標識，請求集裝箱最新數(shù)據(jù)；b) 通過UserToken、集裝箱標識、時間范圍，請求集裝箱歷史數(shù)據(jù)。4.3 被動方式被動方式是指第三方平臺被動接收來自集裝箱平臺的數(shù)據(jù)，步驟如下：a) 用戶設(shè)置第三方平臺接收數(shù)據(jù)的URL地址；b) 集裝箱平臺接收到數(shù)據(jù)后，主動請求第三方5 數(shù)據(jù)交換格式5.1 數(shù)據(jù)格式定義第三方平臺與集裝箱平臺之間進行數(shù)據(jù)對接采用協(xié)議。請求參數(shù)為URL參數(shù)，返回數(shù)據(jù)格式為JSON，字符編碼為UTF-8，消息總長度應不超過100K字節(jié)。5.2 獲取

Usertoken5.2.1接口調(diào)用地址接口調(diào)用地址為：。5.2.2 請求方式采用HTTP/HTTPS協(xié)議的請求方式。5.2.3 請求參數(shù)說明POST請求參數(shù)如表1所示。表1

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

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

"message":

{"userToken":

"s*EK0B8GsS5LEE1V*HW1*w==", ................................."mqttToken":

"vC3JALZ4UrmjqswA3izD2Q==","groupData":

T/SCA

018-2021},"success":

} 錯誤情況平臺返回錯誤碼等信息給調(diào)用端，錯誤碼說明如表2所示。表2表2

錯誤碼說明{"errcode":500,"message":""}5.3 服務(wù)器

IP

地址或域名設(shè)置5.3.1 接口調(diào)用地址接口調(diào)用地址為：。5.3.2 請求方式采用HTTP/HTTPS協(xié)議的請求方式。5.3.3 請求參數(shù)說明POST請求參數(shù)如表3所示。表3

請求參數(shù)說明5.3.4表3

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

"message":

T/SCA

018-2021"success":

} 錯誤情況平臺返回錯誤碼等信息給調(diào)用端。{"errcode":500,"message":""}5.4 請求所有集裝箱標識列表5.4.1 接口調(diào)用地址接口調(diào)用地址為：。5.4.2請求方式采用HTTP/HTTPS協(xié)議的請求方式。5.4.3 請求參數(shù)說明POST請求參數(shù)如表4所示。表4

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

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

"total":

[{

"88.126.1/PRD.CONT.25RST.HLBU9320355",//集裝箱標識"operateTime":

03:16:48",

//操作時間..... 其他數(shù)據(jù)字段},{......... 省略}......... 省略......],"success":

true,

T/SCA

018-2021"msgInfo":

"成功"}5.5 標識檢索5.5.1 接口調(diào)用地址接口調(diào)用地址為：containernode/searchContainer。5.5.2 請求方式采用HTTP/HTTPS協(xié)議的請求方式。5.5.3 請求參數(shù)說明POST請求參數(shù)如表5所示。表5

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

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

"message":

data:[里面放多條業(yè)務(wù)數(shù)據(jù),格式不限制]"success":

}"data":[

"88.126.1/PRD.CONT.45G1.SEGU9431435",,"boxNo":"SEGU9431435",T/SCA

018-2021"manufacturerNo":"QCRC","manufacturingCountry":null,"inspectionDate":"2021-04-17

"updateUser":null,"updateTime":null,"identityRetrievalAddress":"","handle":"88.126.1/PRD.CONT.41RST.SEGU9431435","handle2":"88.126.1/PRD.CONT.41RST.SEGU9431435","latitude":22.4925530000000009067662176676094532012939453125,"longitude":113.876855000000006157279131002724170684814453125,"operatePlace":null,

08:41:23",","inspectiondate":null,"businessOuts":null,5.6標識歷史數(shù)據(jù)檢索5.6.1 接口調(diào)用地址接口調(diào)用地址為：。5.6.2請求方式采用HTTP/HTTPS協(xié)議的請求方式。5.6.3 請求參數(shù)說明POST請求參數(shù)如表6所示。

T/SCA

018-2021表6

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

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

"message":

data:[里面放多條業(yè)務(wù)數(shù)據(jù),格式不限制]"success":

}"data":["Identifer":

"88.126.1/PRD.CONT.45G1.SEGU9431435",,"boxNo":"SEGU9431435","manufacturerNo":"QCRC","manufacturingCountry":null,"inspectionDate":"2021-04-17

"updateUser":null,

T/SCA

018-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.876855000000006157279131002724170684814453125,"operatePlace":null,

08:41:23",","inspectiondate":null,"businessOuts":null,5.7設(shè)置數(shù)據(jù)推送

地址5.7.1接口調(diào)用地址接口調(diào)用地址為：。5.7.2 請求方式采用HTTP/HTTPS協(xié)議的請求方式。5.7.3 請求參數(shù)說明POST請求參數(shù)如表7所示。表7

請求參數(shù)說明5.7.4表7

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

"message":

T/SCA

018-2021"success":

}5.8 第三方平臺接收推送集裝箱平臺通過向第三方平臺進行數(shù)據(jù)推送，首先需要用戶提供接收推送數(shù)據(jù)的URL地址，并且