基于NB-IoT的供热业务 室温采集器应用平台接口技术要求

3基于NB-loT的供热业务室温采集器应用平台接口技术要求本文件规定了基于NB-IoT的室温采集器应用平台接口技术要求，包含平台系统架构、平台接口协议、业务流程、接口定义要求。本文件适用于NB-IoT室温采集器产品设计和研发，适用于政府供热监管部门、供热企事业单位室温采集器应用平台建设的决策参考，也适用于第三方机构对NB-IoT室温采集器技术审查和评估。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款，其中，注日期的引用文件，仅该日期对应的版本适用于本文件。不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。YD/TAAAA-AAAA基于NB-IoT的供热业务室温采集器总体技术要求3术语和定义下列术语和定义适用于本文件NB-loT室温采集器roomtemperatureacquisitionbasedonNB-loT安装在热用户室内固定位置，内置温度传感或变送器件采集室内温度，并通过内置NB-IoT基础通信套件和用户卡把采集温度上传至NB-IoT物联网平台的电子设备。此基础通信套件实现物联网终端与NB-IoT物联网平台的通信、应用数据传输及设备管理等功能。此用户卡作为用户身份标识，采用物联网专用号段，基于NB-IoT网络通信/主要提供存储安全数据、动态加载更新应用、安全运算、标识用户身份、鉴权接入等功能。NB-IoT物联网平台narrowbandinterne为NB-IoT室温采集器提供接入服务、连接管理、设备管理、数据缓存及转发、应用使能服务的物联网平台。业务平台serviceplatform为NB-IoT室温采集器提供终端管理、用户管理、客户交互界面的供热行业的业务平台。44符号和缩略语下列缩略语适用于本文件。API:应用程序接口(ApplicationProgrammingInterface)header:标头，是服务器HTTP协议传HIML资料到浏览器前所送出的字串HTTPS:超文本传输安全协议(HyperTextTransferProtocoloverSecureSocketLayer)IMEI:国际移动设备识别码(InternationalMobileEquipmentIdentity)IMSI:国际移动用户识别码(InternationalMobileSubscriberIdentity)IoT:物联网(InternetofThings)JSON:JavaScript对象简谱(JavaScriptObjectNotation),一种轻量级的数据交换格式5系统架构系统架构应符合YD/TAAAA-AAAA第6章的定义。通信运营商NB-IoT物联网平台和热力公司业务平台之间是多对多关系，此处的业务平台是指热力公司的设备管理业务平台。6平台接口协议概述为满足NB-IoT物联网平台与业务平台、安全认证平台之间的业务及管理要求，本文件对这三个平台之间的业务流程、接口定义进行规范通信运营商物联网平台设备接入过程如下：1)热力公司登录通信运营商NB-IoT物联网平台，注册新的NB-IoT物联网采集器，分配唯一的编号2)热力公司可在自己业务平台上给NB-IoT物联网采集器分配一个设备厂家出场时的设备编号；3)热力公司可在通信运营商NB-IoT物联网平台给deviceld关联(2)中的设备编号，作为别称：4)热力公司在业务平台上填写通信运营商NB-IoT物联网平台分配的编号完成匹配5)热力公司的业务平台可向NB-IoT物联网平台下发注册添加NB-IoT室温采集器指令，流程如图1所示：5业务平台业务平台NB-1oT物联网平台使用App_Key和IMEI发送注册请求返回注册信息图1注册NB-loT室温采集器流程6)NB-IoT平台会周期性的给业务平台推送数据，例如温度数据、时间等，业务平台收到后认为设备注册成功，可正常使用。7.2查询设备基础信息业务平台可向NB-IoT物联网平台下发查询NB-IoT室温采集器基础信息指令，流程如图2所示；下发基础信息查询请求返回基础信息详情图2查询NB-loT室温采集器基础信息流程7.3查询设备在线状态6下发删除请求返回删除结果信息7.7数据查询业务平台可向NB-IoT物联网平台下发数据查询指令，流程如图7所示。图7数据查询流程业务平台可向NB-IoT物联网平台下发设备远程设置指令，指令到达后，NB-IoT物联网平台缓存待设备下一次上线后把指令下发，设备返回设置指令的响应结果，流程如图8所示。业务平台NB-IoT物联网平台下发设置请求返回设置结果信息推送指令设置结果信息返回推送处理结果8.1通用接口NB-IoT室温采集器在NB-IoT物联网平台注册成功后，此平台向业务平台发送注册结果通知消息，需要约定通用结果和公共参数。用户可通过HTTPS调用，开展NB-IoT室温采集器设备管理、数据查询、日常抄表等操作，在API的基础上根据用户个性化需求搭建上层应用。此时，发起方是NB-IoT物联网平台，接收方是业务平台。AppID编码应满足以下要求；a)数据类型为字符串：b)显示名称为应用D₁c)字段描述是NB-IoT物联网平台颁发的应用唯一标识；d)不应超过255个字节。deviceID编码应满足以下要求：a)数据类型为字符串：b)显示名称为设备ID;c)字段描述是NB-IoT室温采集器在平台侧的设备唯一标识码：d)不应超过255个字节。8.1.1接口整体结构请求方法需要符合Restful格式，其中添加类的请求采用post、查询类的请求采用get、删除类delete、修改类的请求采用put.接口地址：https://ldomain)/模块/(nethod},接口域domain即标识接口所属的模块。接口首行，应出现appId消息体：包括公共、业务参数两部分。返回结果定义见表1。表1返回结果定义须是是否返回结果详情见表2。0123456789