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

55.180.10A

85 T/SCA

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

interface

specification

secondary-level

node

platform

of

freightcontainer2021

–

10

-

08

發(fā)布

11-

08

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

布T/SCA

018-2021 前言

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

范圍

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

12

規(guī)范性引用文件

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

13

術(shù)語(yǔ)和定義

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

14

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

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

15

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

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

26

通信安全機(jī)制

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

9T/SCA

018-2021 本文件按照GB/T

1.1―《標(biāo)準(zhǔn)化工作導(dǎo)則

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

018-20211范圍本文件規(guī)定了工業(yè)互聯(lián)網(wǎng)集裝箱二級(jí)節(jié)點(diǎn)平臺(tái)與第三方平臺(tái)之間數(shù)據(jù)通信的對(duì)接流程與要求、數(shù)據(jù)交換格式和通信安全機(jī)制。本文件適用于工業(yè)互聯(lián)網(wǎng)集裝箱二級(jí)節(jié)點(diǎn)平臺(tái)與第三方平臺(tái)之間的數(shù)據(jù)交換。2 規(guī)范性引用文件凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。T/SCA

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

集裝箱

標(biāo)識(shí)編碼規(guī)范3 術(shù)語(yǔ)和定義下列術(shù)語(yǔ)和定義適用于本文件。3.1集裝箱身份標(biāo)識(shí)UTF-8字符“/”項(xiàng)為可選，用于唯一識(shí)別標(biāo)識(shí)對(duì)象。3.2工業(yè)互聯(lián)網(wǎng)集裝箱二級(jí)節(jié)點(diǎn)平臺(tái)4 對(duì)接流程與要求4.1 對(duì)接流程第三方平臺(tái)與集裝箱平臺(tái)之間的對(duì)接流程如下：a) 在集裝箱平臺(tái)進(jìn)行賬號(hào)注冊(cè)；b) 利用已注冊(cè)的賬號(hào)、密碼登錄平臺(tái)，通過(guò)API接口獲取UserToken；c) 設(shè)置服務(wù)器的

地址或域名，通過(guò)

UserToken

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

T/SCA

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

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

請(qǐng)求參數(shù)說(shuō)明5.2.4表1

請(qǐng)求參數(shù)說(shuō)明5.2.4 返回說(shuō)明平臺(tái)返回下述數(shù)據(jù)包給調(diào)用端：{

"message":

{"userToken":

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

"vC3JALZ4UrmjqswA3izD2Q==","groupData":

T/SCA

018-2021},"success":

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

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

IP

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

請(qǐng)求參數(shù)說(shuō)明5.3.4表3

請(qǐng)求參數(shù)說(shuō)明5.3.4返回說(shuō)明平臺(tái)返回下述數(shù)據(jù)包給調(diào)用端：{

"message":

T/SCA

018-2021"success":

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

請(qǐng)求參數(shù)說(shuō)明5.4.4表4

請(qǐng)求參數(shù)說(shuō)明5.4.4 返回說(shuō)明{

"total":

[{

"88.126.1/PRD.CONT.25RST.HLBU9320355",//集裝箱標(biāo)識(shí)"operateTime":

03:16:48",

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

true,

T/SCA

018-2021"msgInfo":

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

請(qǐng)求參數(shù)說(shuō)明5.5.4表5

請(qǐng)求參數(shù)說(shuō)明5.5.4 返回說(shuō)明{

"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標(biāo)識(shí)歷史數(shù)據(jù)檢索5.6.1 接口調(diào)用地址接口調(diào)用地址為：。5.6.2請(qǐng)求方式采用HTTP/HTTPS協(xié)議的請(qǐng)求方式。5.6.3 請(qǐng)求參數(shù)說(shuō)明POST請(qǐng)求參數(shù)如表6所示。

T/SCA

018-2021表6

請(qǐng)求參數(shù)說(shuō)明5.6.4表6

請(qǐng)求參數(shù)說(shuō)明5.6.4返回說(shuō)明{

"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 請(qǐng)求方式采用HTTP/HTTPS協(xié)議的請(qǐng)求方式。5.7.3 請(qǐng)求參數(shù)說(shuō)明POST請(qǐng)求參數(shù)如表7所示。表7

請(qǐng)求參數(shù)說(shuō)明5.7.4表7

請(qǐng)求參數(shù)說(shuō)明5.7.4 返回說(shuō)明{

"message":

T/SCA

018-2021"success":

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