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

ICS55.180.10A85Specificationsofsubscriberaccessandidentlevelnodeplatformoffreig深圳市智能集装箱技术协会T/SCA019-2021前言 2规范性引用文件 3术语和定义 4用户注册 5标识前缀申请 6标识数据同步 7数据交换格式 8通信安全机制 ⅠT/SCA019-2021T/SCA019-2021本文件按照GB/T1.1―2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由深圳市智能集装箱技术协会提出和归口。本文件起草单位：深圳中集智能科技有限公司、深圳市标准技术研究院、交通运输部水运科学研究所、上海理想信息产业（集团）有限公司、厦门卫星定位应用股份有限公司。本文件主要起草人：周受钦、刘浩、李继春、李媛红、权进国、易晓珊、张曙光、盛骏、张旭杰、杨小明、廖星星、吕洁印、李大命、文常强、江培舟、李志扬、李佳骏、陈雷。Ⅱ1工业互联网集装箱二级节点平台用户接入与标识管理规范本文件规定了工业互联网集装箱二级节点平台的用户注册、标识前缀申请、标识数据同步、数据交换格式和通信安全机制。本文件适用于工业互联网集装箱二级节点平台的用户接入与标识管理。2规范性引用文件凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。T/SCA013工业互联网标识解析集装箱标识编码规范3术语和定义下列术语和定义适用于本文件。3.1集装箱身份标识集装箱身份标识包括标识前缀和标识后缀两部分，前缀与后缀之间以UTF-8字符“/”分隔，其中标识前缀由国家代码、行业代码、企业代码组成，用于唯一标识企业主体；标识后缀由物品类别代码、物品名称代码、物品型号规格代码、物品序列号代码、日期代码、企业内部物品编码和其他项组成，其他项为可选，用于唯一识别标识对象。3.2工业互联网集装箱二级节点平台能够实现集装箱身份标识注册、解析、检索，企业信息注册、企业信息审核、集装箱数据上报、历4用户注册手机号等信息。5标识前缀申请5.1申请标识前缀2T/SCA019-2021用户应在集装箱平台在线申请集装箱身份标识前缀。申请流程如下：a）申请者如实填写企业信息，具体包括：企业名称企业类型机构证件类型证件照片统一社会信用代码所属行业注册所在地法人姓名法人证件类型法人证件号码联系人姓名联系人手机联系人邮箱联系人身份证b）等待二级节点系统管理员和顶级节点管理员审核；c）审核通过后，获得标识。5.2信息变更标识前缀申请成功后，若需要变更企业信息，需由企业用户再次通过集装箱平台提交申请。企业信息变更包括以下两类：a）全量修改：修改企业类型、机构证件类型、统一社会信用代码、所属行业、注册所在地、法人证件类型、法人姓名，需要二级节点管理员和顶级节点管理员审核通过；b）部分修改：修改企业类型、机构证件类型、统一社会信用代码、所属行业、注册所在地、法人证件类型、法人姓名之外的信息，只需要二级节点管理员审核通过。6标识数据同步6.1标识创建用户向集装箱平台发起标识创建动作，内容包括handle标识、附加数据等，集装箱平台收到数据后，返回数据入库成功或失败状态。6.2标识修改用户向集装箱平台发起标识修改动作，内容包括handle标识、附加数据等，集装箱平台收到数据后，返回数据入库成功或失败状态。标识附加数据是指一个集装箱身份标识产生的各类业务数据，如位置、状态、操作（生产下线、托运、报关、通关、堆场、装船、卸船、船运、维修等）。可以采用标识修改方式，由用户向集装箱平台发起标识附加数据上报动作，集装箱平台收到数据后，返回数据入库成功或失败状态。6.3标识删除T/SCA019-2021用户向集装箱平台发起标识删除动作，内容包括handle标识、附加数据等，集装箱平台收到数据后，返回数据入库成功或失败状态。6.4标识检索用户向集装箱平台发起标识检索动作，集装箱平台收到数据后，返回集装箱标识和附加业务数7数据交换格式7.1数据格式定义用户应用系统与集装箱平台之间的数据交互采用HTTP/HTTPS协议，返回数据格式为JSON，消息总长度应不超过100K字节。7.2用户注册7.2.1接口调用地址接口调用地址为：user/register。7.2.2请求方式7.2.3请求参数说明POST请求参数如表采用HTTP/HTTPS7.2.3请求参数说明POST请求参数如表是是表1表1求参6是正常情况平台以正常情况平台以JSON数据包返回参数信息。参数说明如表2所示。3是是表2表2回参数说明数说明否3T/SCA019-2021}码说明如表3所示。错误情况平台以JSON数据包返回错误码等信息，错误7.3用户登录7.3.1接口调用地址接口调用地址为：user/login。7.3.2请求方式是表4表4请求参数说明7.3.3请求参数说明POST请求参数如表4所示。采用HTTP/HTTPS协议的POST请求方式。7.3.4返回说明正常情况平台返回下述JSON数据包给调用端：{"errorCode":200,"message":"Success","data":{"userToken":"s*EK0B8GsS5LEE1V*HW1*w==","mqttToken":"vC3JALZ4UrmjqswA3izD2Q==","groupData":null4T/SCA019-2021}错误情况平台以JSON数据包返回错误码等信息。7.4企业标识前缀申请7.4.1接口调用地址接口调用地址为：enterprise/enroll。7.4.2请求方式7.4.3请求参数说明POST请求参数如表5所示。数采用HTTP7.4.3请求参数说明POST请求参数如表5所示。数是是是表5请求参是是是是是是是是是是是是是是是是是是7.4.4返回说明正常情况下平台返回下述JSON数据包给调用端：{"errorCode":200,T/SCA019-2021"message":"Success",}7.5标识新增7.5.1接口调用地址接口调用地址为：containernode/insert。7.5.2请求方式采用HTTP/HTTPS协议的POST请求方式。7.5.3请求参数说明是是是是7.5.4返回说明正常情况下，平台返回下述JSON数据包给调用端：{}7.6标识修改7.6.1接口调用地址接口调用地址为：containernode/update。7.6.2请求方式采用HTTP/HTTPS协议的POST请求方式。是POST请求参数如表7所示。POST请求参数如表6所示。7.6.3请求参数说明6表7请求参数说明是是是是7.6.4返回说明正常情况下，平台返回下述JSON数据包给调用端：{"errorCode":200,"message":"Success",}7.7标识删除7.7.1接口调用地址接口调用地址为：containernode/delete。7.7.2请求方式采用HTTP/HTTPS协议的POST请求方式。是是T/SCA019-20217.7.3请求参数说明POST请求参数如表8所示。7.7.4返回说明正常情况下，平台返回下述JSON数据包给调用端：{}7.8标识检索7.8.1接口调用地址接口调用地址为：containernode/searchContainer。7.8.2请求方式78T/SCA019-2021采用HTTP/HTTPS协议的POST请求方式。7.8.3请求参数说明是POST请求参数如表9所示。7.8.4返回说明正常情况下，平台返回下述JSON数据包给调用端：{"errorCode":200,"message":"Success",data:[里面放多条业务数据,格式不限制]}{{T/SCA019-20219"identityRetrievalAddress":"contai"handle":"88.126.1/PRD.CONT.41RST."handle2":"88.126.1/PRD.CONT.41RST."latitude":22.4925530000000009067662176676094532"longitude":113.876855000000006157279131002724170}}8通信安全机制8.1数据安全用户应用系统和集装箱平台建立连接后，双方交换加密所用密钥，后续数据采用指定的密钥对数据进行加密传输。加密算法推荐采用