物联网标识体系Ecode平台接入规范

物联网标识体系Ecode平台接入规范

国家标准 GB/T36604一2018 物联网标识体系Ecode平台接入规范 speifeatons Identiffieatonsystemforinterneofthings一Ecodeplatform acceSs 2018-09-17发布 2019-04-01实施 国家市场监督管理总局 发布 国家标准化管理委员会国家标准
GB/T36604一2018 次 目 前言 范围 2 规范性引用文件 3 术语和定义 缩略语 Ecode平台接人方式 Web方式接人Ecode平台 接口方式接人Ecode平台 8 接口定义及描述 -- 附录A规范性附录接口和数据结构
GB/36604一2018 前 言 本标准按照GB/T1.1一2009给出的规则起草 本标准由全国物晶编码标准化技术委员会(SAC/TC287)提出并归口 本标准起草单位;物品编码中心、信息通信研究院、合肥金维思特智能科技有限公司、烟台 东方瑞创达电子科技有限公司、西安电子科技大学、中检集团溯源技术服务有限公司、科学院国家 授时中心,复旦大学,交通运输部水运科学研究院、科学院计算机网络信息中心,深圳市标准技术研 究院、北京农业信息技术研究中心 本标准主要起草人;张旭,王妹,刘阳、,刘巍,田娟,、陈浩、伸伟、刘小峰、胡世伟、李晖、,王成杰、张健、 李志勇、王俊宇,李继春,李媛红、田野、刘佳、周哲、李凯迪、期洽博、孙传恒、杨信廷、韩树文、张楠、杜景荣、 王尚书
GB/36604一2018 物联网标识体系Ecode平台接入规范 范围 本标准规定了Ecode平台的接人方式和接口定义 本标准适用于基于Ecode平台实现跨系统、跨平台互联互通的应用 规范性引用文件 下列文件对于本文件的应用是必不可少的 凡是注日期的引用文件,仅注日期的版本适用于本文 件 凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件 GB/T31866物联网标识体系物品编码Ecode GB/T35422物联网标识体系Ecode的注册和管理 术语和定义 GB/T31866界定的以及下列术语和定义适用于本文件 3.1 第三方平台thirlpartyplatform" 通过中间软件,为应用企业提供Eode编码服务,其作用独立于Ecde平台的平台 缩略语 下列缩略语适用于本文件 HTTP;超文本传输协议(HyperTextTransferProtocol) JsON;Js对象标记(JavaSeriptObjgectNotation) URL;统一资源定位符(UniformResourcelocator) Ecode平台接入方式 Ecode平台(Ecode国家物联网标识管理与公共服务平台)提供两种方式与外部接人.web方式和 接口方式 web方式接人:用户登录Ecode平台后,通过平台web页面功能实现接人 接口方式接人:用户或第三方平台采用HTTP协议接口方式实现接人 web方式接入Ecodle平台 6 web方式接人Ecode平台流程如图1所示
GB/T36604一2018 Eeoke编码下载 用户注册 Ecode编码申请 Ecodc编码回传 Ecode编码查询 图1web方式接入Ecde平台流程图 流程图中的具体要求如下 用户注册 a 用户注册流程见GB/T35422; Ecode编码申请 b 用户注册成功后,可在Ecode平台上申请Ecode编码 申请流程见GB/T35422:; Ecode编码下载: Ecode编码申请审核通过后,可在Ecode平台下载Ecode编码; d Ecode编码回传: 用户可将Ecode编码和对应的产品信息回传到Ecode平台 编码回传数据项见附录A的表 A.6 Ecode编码查询: 用户可在平台上查询Ecode编码对应的产品回传信息 接口方式接入Ecde平台 7.1用户接入 用户通过接口方式接人Ecode平台流程如图2所示 编码申请 Ecot编码下载 用户注册 Ecode Ecode编码回传 Ecodle编码查询 接口) 接口 (接口) (接口) 图2接口方式接入Ecode平台流程图 流程图中的具体要求如下 用户注册 a 注册流程见GB/T35422; b Ecode编码申请 调用编码申请接口,申请Ecode编码,编码申请接口数据项见表A.7; Ecode编码下载 调用编码下载接口,下载Ecode编码文件,编码下载接口数据项见表A.8 d Ecode编码回传 调用编码回传接口,回传Ecode编码和相关产品信息,编码回传接口数据项见表A.9 7.2第三方平台接入 第三方平台通过接口方式接人Ecode平台流程如图3所示
GB/T36604一2018 Ecod编码回传 Eco6 nl编码申请 Ecode 编码查询 第三方平台 Ecodc编码下载 企业信息导入 接口 (接口) 接口) 接口 (接口) 注册 图3第三方平台接口方式接入Ecode平台流程图 流程图中的具体要求如下 a 第三方平台注册: 注册流程见GB/T35422 注册数据项见表A.10, 企业信息导人 b 调用企业信息导人接口,将已接人第三方平台的企业用户导人到Ecode平台中,企业信息导人 数据项见表A.11; Ecode编码申请 调用编码申请接口,申请Ecode编码,编码申请接口数据项见表A.7; Ecode编码下载 调用编码下载接口,下载Ecode编码文件,编码下载接口数据项见表A.8 编码回传 调用编码回传接口，回传Ecode编码和对应的企业、产品信息，编码回传接口数据项见 表A.12 接口定义及描述 8.1code接口定义 Ecode平台接口名称及说明见表1 表1Ecode平台接口列表 说明 接口 编码申请 生成Ecode编码 ecodeApply ecodeDownload 编码下载 下载Ecode编码 编码回传 ecodeReturn 回传Ecode编码 编码查询 ecodeSeleet 查询Ecode编码 8.2Ecode接口描述 8.2.1编码申请 接口名称:eeodeApply 接口协议:HTTP,HTTPS. 调用参数输人用户认证码,编码数量 返回值:状态值,文件标识码 接口功能:用户根据已经分配的认证码,进行Ecode编码申请,生成Ecode编码文件
GB/T36604一2018 8.2.2编码下载 接口名称:ecodeDownload. 接口协议:HTTP,HTTPS 调用参数;输人用户认证码,文件标识码} 返回值:{状态值,编码数量) 接口功能:用户根据已经分配的认证码和编码申请接口返回的文件标识码,对编码文件进行下载 8.2.3编码回传 接口名称:ecodeReturn. 接口协议;HTTP,HTTPS 调用参数:输人{用户认证码,产品信息) 返回值:状态值,回传编码数量》 接口功能;用户和第三方平台在将Eeode编码使用到产品后,将Ecode编码及该编码所携带的产品 信息回传到Ecode平台 8.2.4编码查询 接口名称:ecodeSelect 接口协议:HTTPHTTPs 调用参数;输人用户认证码,Ecode编码》 返回值:公司信息,产品信息,其他更多信息) 接口功能;Ecode编码回传成功后,可查询回传的企业及产品信息 8.2.5接口数据格式及错误代码含义 接口返回数据格式: 企业及第三方平台对Ecode平台接口返回数据的数据格式为JsON,所有数据文件内容采用UTF-8 编码 接口错误代码含义 Ecode平台接口返回的错误代码含义见表A.5
GB/36604一2018 附 录 A 规范性附录 接口和数据结构 A.1平台接口 A.1.1编码申请 y/celientld=clientld/numb=100. 接口地址如:http:// odeApply www.iotroot.com/interface/eco6 参数说明见表A.1 表A.1编码生成接口参数说明 类型 说明 名称 clientld 输人参数 用户认证码,根据GB/T35422注册成功后系统分配的D nuumb 输人参数 编码数量 返回值 200代表返回成功,400代表返回失败 status fileld 返回值 文件标识码 示例: http;//www,.iotroot,.com/interface/ecodeApply/elientld=s4eflkur329872kdeak18umdhy5k8dt4/numb=100 返回JsoN格式数据: "status":200 "info"; "flelad","1444720302248100969123213456" A.1.2编码下载 接口地址如:http://www..iotroot.com/interface/ecodeDownload/elientd=clientld/fileld- fleld),参数说明见表A.2 表A.2编码下载接口参数说明 名称 类型 说明 输人参数 clientld 用户认证码 输人参数 fileld 文件标识码 status 返回值 200代表返回成功,400代表返回失败 返回值 下载编码数量 codeNum 示例: slelkur329872kdeakl6 1umlhxaksit4)/iaad http://www.iotroot.com/general/downloadcode/elientld 1444720302248100969123213456 返回JsON格式结果 "status";200
GB/T36604一2018 "info": "codeNum","1000" A.1.3编码回传 接口地址如;http;/www/iotroot.com/ecodeReturn/elientld=(clientld,参数说明见表A.3. 表A.3编码回传接口参数说明 说明 名称 类型 dlentld 输人参数 用户认证码 Post数据 输人参数 JS(ON数据格式 返回值 200代表返回成功,400代表返回失败 status backnumb 返回值 回传编码数量 示例 http://www.iotroot.com/ecodeReturn/backJson/clientld=s4eflkur329872kdeak18umdhy5k8dt4 PostJsON格式数据如下 "contents"; "data"; "key";"产品名称","value";"实验室产品1") ","value";"6901230323421" "商品条码" "key" ecode";"1009613213213123，10096132132131234" "photo";"二进制图片资源" ;产品属性及属性值 data; ecode};ecode编码,多个用","隔开 ophoo)产品图片(二进制图片资源). 返回JsON格式结果 "status";200. "info" "backnumb":"1000" A.1.4编码查询 codeSele le/dlient=(elient)/E=(eocde),参数说 接口地址如:http://www.iotroot.com/interface/eco 明见表A.4
GB/36604一2018 表A.4编码查询接口参数说明 名称 类型 说明 输人参数 Ecode编码 输人参数 用户认证码 clientld 返回值 200代表返回成功,400代表返回失败 status 返回值 公司信息项 key company value 返回值 公司信息项内容 返回值 产品信息项 key info product value 返回值 产品信息项内容 key 返回值 更多信息项 mmore 返回值 更多信息项内容 vaue 示例" http://www.iotroot.com/interface/clientld=s4eflkur329872kdeak18umdlhy5k8dt4/E= 10096324312312740274303242 返回JS(ON格式结果: 行 "status";200,"readCount";487,"exception"; "info" "company" "key";"用户名称","value";"物联网实验室")， "key":"用户地址","value";"东城区皇城国际B座"y "key""联系方式","value";"o10-398382924" "produet" ("key":"产品名称","value";"物联网产品1" "key";"产品规格","value" ";"产品规格示例". -级" "key""执行等级","walue" "key photo" value" http://iotroot.com/image/801692364520.jpg"， "key" .”\e ogophoto","value";"http://iotroot.com/image/ /591406726816.jpg" TlO "value" "详情" "更多介绍". 'value" "value";"物品编码中心"， key comName "key 'buttonTitle","value" "点击查看更多" "key";"blockURI","value";"http://wwww.iotroot.com/E=10009659146301837"， "key";"pageRI","value";"http://wwww.iotroot.com/E=10009659146301837"
GB/T36604一2018 A.1.5平台接口错误数据格式 平台接口均采用HTTP协议,接口调用失败返回如下JSON格式结果 "status":400, "info" 'success";false， errorCode";"10001" error brMsg";"编码不存在" 错误代码含义见表A.5 表A.5Eeode平台接口错误代码含义 名称 说明 0001 编码不存在 账号不存在 10002 10003 密码错误 10004 账号未审核完成 账号已被注销 0005 30001 编码数量输人不合法 30002 编码数量超出最大值200000 30006 剩余编码数量不足,无法分配 编码文件不存在 0001 40002 编码文件标识码不存在 50001 回传失败 数据结构 A.2 数据结构见表A.6一表A.12 表A.6编码回传数据项 输人项 是否必填 描述 是 在线和附件两种方式 回传方式 是 Ecode编码 选择分类 是 选择查询模板分类 是 分类信息维护 自定义查询模板 表A.7Ecode编码申请接口数据项 是否必填 输人项 描述 dlientld 是 URL编码传输 number 是 10000200000整数
GB/36604一2018 表A.8Ecode编码下载接口数据项 输人项 是否必填 描述 dlientld 是 URL编码传输 fled 是 表A.9用户Ecodle编码回传接口数据项 输人项 是否必填 描述 clientldl 多个Ecode编码用逗号或回车分割 Ecode 产品图片 真实产品图片,大小不超过300KE 是 产品属性 商品条码需真实填写 表A.10第三方平台注册数据项 输人项 是否必填 描述 是 不少于6位 用户名 平台名称 联系人 授权联系人 联系电话 联系地址 平台网站地址 平台主体 是 电子邮箱 平台介绍 是 表A.11第三方平台企业信息导入数据项 类型 参数 说明 comCNName 企业中文名称 regAddressCNName 注册地址中文 联系人 contact 境外企业 telNum 联系电话 contaetMail 电子邮箱 businessCard 证明文件 comCNName 企业中文名称 regAddressCNName 注册地址中文 orgCode 统一社会信用代码 联系人姓名 contact 国内企业 telNum 联系电话 contactMai 联系人电子邮箱 营业执照 businessCard
GB/T36604一2018 表A.12第三方平台Ecde编码回传接口数据项 输人项 是否必填 描述 000000000000一999999999999 是 区间 12位数字组成的字符串 企业信息 编码使用企业 ID 是 产品信息 编码绑定的产品信息 是 0

物联网标识体系Ecode平台接入规范GB/T36604-2018

随着物联网的快速发展，越来越多的智能设备和终端开始接入网络，形成了一个庞大的物联网生态系统。而在这个生态系统中，设备的标识和管理是非常重要的一环。如果没有一个统一的标识体系，那么设备之间的通信和管理就会变得异常困难。

为了解决这个问题，国家发布了《物联网标识体系Ecode平台接入规范》（GB/T36604-2018）。该规范旨在建立一个统一的、开放的标识体系，为物联网设备的标识和管理提供支持。

GB/T36604-2018规定了Ecode平台的接口规范、标识规范和数据格式规范等内容。在使用Ecode平台进行设备接入时，需要遵循这些规范，以确保设备的标识和管理的一致性和可靠性。

具体来说，GB/T36604-2018规定了Ecode平台的接口规范，包括基本接口、查询接口、注册接口、删除接口等。同时，该规范还规定了设备标识的构成方法和规则，以及标识编码的分配方式和管理方法。此外，GB/T36604-2018还规定了设备数据格式的标准化要求，包括数据内容、格式、编码等方面。

通过遵循GB/T36604-2018规范，可以实现不同设备之间的互联互通，促进设备之间的协同工作，提高物联网系统的整体效率。同时，统一的标识体系也方便管理人员对设备进行追踪和管理，为设备运维工作提供帮助。

总之，在建立一个庞大的物联网生态系统中，设备的标识和管理是非常重要的。国家发布的《物联网标识体系Ecode平台接入规范》（GB/T36604-2018）为设备的标识和管理提供了支持和规范，使得不同设备之间的互联互通变得更加便捷和可靠。

物联网标识体系Ecode平台接入规范的相关资料

和物联网标识体系Ecode平台接入规范类似的标准