T-SCA 019-2021 工业互联网集装箱二级节点平台用户接入与标识管理规范

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