食品安全电子溯源物联网信息目录服务(iotDS)接口标准.docxVIP

ICS?93.020P22备案号：DB32江苏省地方标准DB 32/ T XXXX—XXXX?????食品安全电子溯源物联网信息目录服务(iotDS)接口标准?????点击此处添加与国际标准一致性程度的标识(草案)?????XXXX-XX-XX发布XXXX-XX-XX实施江苏省质量技术监督局???发布目??次目??次I前??言II食品安全电子溯源物联网信息目录服务（iotDS）接口标准11范围12规范性引用标准13术语13.1 赋码13.2 JSON14缩略语15iotDS概述25.1 iotDS的基本功能25.2 iotDS的扩展功能26iotDS基本功能接口26.1身份验证接口26.2 注册接口26.2.1 赋码注册接口26.2.2 事件注册接口46.3 查询接口66.3.1 环节查询接口66.3.2 事件查询接口86.3.3 查询版本号96.4 出错处理97iotDS接口绑定117.1 XML和JSON纲要117.1.1 赋码注册接口返回值117.1.2 事件注册接口返回值117.1.3 环节查询接口返回值117.1.4 事件查询接口返回值12本规程用词说明13前??言iotDS（internet of things discovery service）是物联网信息目录服务的缩写。为进一步推动食品安全电子溯源的发展，制订了食品安全电子溯源物联网信息目录服务接口标准。本标准由提出并归口。本标准起草单位：本标准主要起草人：食品安全电子溯源物联网信息目录服务（iotDS）接口标准范围本规范适用于食品安全电子溯源物联网信息服务（iotDS）接口涉及到的接口定义、调用。本规范为接口的实现和规范化提供依据。规范性引用标准本规范规定了食品安全电子溯源物联网信息服务（iotDS）接口标准：包括食品安全电子溯源物联网信息服务（iotDS）身份验证接口食品安全电子溯源物联网信息服务（iotDS）数据采集接口食品安全电子溯源物联网信息服务（iotDS）信息查询接口本标准主要适用于食品安全电子溯源物联网信息服务（iotDS）接口的技术实现、接口的规范化。术语3.1 赋码是给每件产品赋予唯一的标识。 3.2 JSON数据交换语言。 易于人阅读和编写，同时也易于机器解析和生成(网络传输速率)。3.3 XML可扩展标记语言，标准通用标记语言的子集，是一种用于标记电子文件使其具有结构性的标记语言。缩略语缩略语英文全名中文全名iotDSInternet of thingsDiscovery service物联网目录服务iotISInternet of thingsInformation service物联网信息服务iotDS概述5.1 iotDS的基本功能iotDS为iotIS提供信息目录服务。当单品的信息分布在不同的iotIS上时，用户通过iotDS可以获得与单品相关的所有iotIS的访问方式信息。5.2 iotDS的扩展功能iotDS向终端查询用户提供iotIS信息可信验证，确保终端查询用户获取的信息是原始未被篡改的。iotDS基本功能接口6.1身份验证接口提供客户端注册数据时需要进行登录和授权功能,用户登录成功后获得一个身份验证号，调用其他接口时需要验证号6.2 注册接口6.2.1 赋码注册接口 接口描述标识管理者、标识拥有者通过此接口向iotDS提交标识注册请求。 接口协议应用与服务器之间的数据交互接口使用HTTP协议（基于TCP/IP），使用POST方式提交数据。接口定义遵循RFC1945（HTTP1.0）、RFC2616（HTTP1.1），RFC0959(FTP)，RFC1866（HTML），RFC4627（JSON）。接口消息会以JSON文档的格式通过HTTP协议传输。 接口流程此流程完成商品标识注册请求的提交，具体如下图1所示：（1）、应用提交商品标识注册请求给iotDS；（2）、iotDS收到注册查询请求之后，判断注册类型；（3）、iotDS完成注册。注册接口流程图 接口消息接口消息包含一个JSON文档，其通过接口协议HTTP的body发送出来，具体消息格式根据接口不同，消息格式内容不同。 接口定义标识赋码注册后调用，向iotDS增加档案。名称：regDS功能：想DS标识档案表里新增标识记录,为一件物品生产一个唯一的标识参数：参数名称说明类型是否必填[objectCode]含有单品标识的数组,单品标识，全局唯一，表示该查询单品的唯一标识List必填itemCode商品标识,全局唯一，表示商品的唯一编码String必填compCode企业标识，全局唯一，表示企业的唯一编号String必填locaCode业务点编号，表示当前发生事件的业务位置的编号String必填lot批次号，给同一批次的商品定义的编号String必填prodTime生产