版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领
文档简介
智慧城市设备联接管理与服务平台技术要求managementandserviceplatformfoI前言 2规范性引用文件 13术语和定义 14缩略语 25平台总体框架 35.1概述 35.2总体框架 6平台功能要求 46.1物联层 46.2数据层 96.3服务层 6.4可视化层 6.5运维管理 6.6安全管理 7平台接口要求 7.1接口大类 7.2接口总体要求 7.3Dd接口要求 7.4Da接口要求 7.5Dr接口要求 附录A(资料性)Dd接口示例 附录B(资料性)Da接口示例 附录C(资料性)Dr接口引用清单 参考文献 Ⅲ本文件按照GB/T1.1—2020《标准化工作导则第1部分:标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由全国信息技术标准化技术委员会(SAC/TC28)提出并归口。本文件起草单位:华为技术有限公司、中国电子技术标准化研究院、中电科新型智慧城市研究院有限公司、腾讯云计算(北京)有限责任公司、北京电信规划设计院有限公司、浪潮软件科技有限公司、中移雄安信息通信科技有限公司、潍坊市大数据局、太极计算机股份有限公司、建设综合勘察研究设计院有限公司、泰华智慧产业集团股份有限公司、深圳市龙华区政务服务数据管理局、深圳天致信息工程咨询有限公司、中睿信数字技术有限公司、北京睿呈时代信息科技有限公司、北京清华同衡规划设计研究院有限公司、深圳市敢为软件技术有限公司、成都秦川物联网科技股份有限公司、山东省计算中心(国家超级计算济南中心)、中国联合网络通信有限公司智能城市研究院、浙江大华技术股份有限公司、山东省标准化研究院、深圳市标准技术研究院、中国电子科技集团公司信息科学研究院、中国科学技术大学、广州广电运通金融电子股份有限公司、南京南大智慧城市规划设计股份有限公司、中星技术股份有限公司、成都中科大旗软件有限公司、北京超图软件股份有限公司。1智慧城市设备联接管理与服务平台技术要求本文件给出了智慧城市设备联接管理与服务平台的总体框架,并规定了功能要求、接口要求。本文件适用于智慧城市设备联接管理与服务平台项目的规划、建设、运行和维护。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T22080—2016信息技术安全技术信息安全管理体系要求GB/T22239—2019信息安全技术网络安全等级保护基本要求GB35114—2017公共安全视频监控联网信息安全技术要求GB/T35319—2017物联网系统接口要求3术语和定义下列术语和定义适用于本文件。具备通信能力的终端或具备通信能力和计算能力的网关。注:除具备通信能力,设备也可具备传感、控制、数据获取、数据存储、数据处理、数据加密等能力。智慧城市设备联接管理与服务平台smartcitymanagementandserviceplatformfordeviceconnec-tion实现智慧城市设备和行业应用集成开放的一种信息系统,通过不同通信协议和开放接口,提供多行业设备(3.1)联接管理、数据管理功能,为行业应用提供数据与服务的支撑能力。对设备(3.1)属性、状态、功能等进行抽象化描述的一种对象模型。边缘管理edgemanagement一种在网络边缘侧对感知、传输、决策等提供管理功能的分布式计算。注:管理功能可发生在边缘侧或接近边缘侧,其接近程度由系统的需求决定。2下列缩略语适用于本文件。API:应用程序编程接口(ApplicationProgrammingInterface)BACnet:楼宇自动化与控制网络(BuildingAutomationandControlnetworks)CAN:控制器局域网络(ControllerAreaNetwork)CMIP:通用管理信息协议(CommonManagementInformationProtocol)CoAP:受约束的应用协议(ConstrainedApplicationProtocol)CORBA:公共对象请求代理体系结构(CommonObjectRequestBrokerArchitecture)Da接口:平台与行业应用的接口(ManagementandServicePlatformforDeviceconnection—Ap-DTLS:数据包传输层安全性协议(DatagramTransportLayerSecurity)HTTP:超文本传输协议(HypertextTransferProtocol)HTTPS:超文本传输安全协议(HypertextTransferProtocolSecure)LonWorks:局部操作网络(LocaloperatingnetWorks)LwM2M:轻量化的M2M协议(lightweightMachinetoMachine)MQTT:消息队列遥测传输协议(Messagequeuingtelemetrytransport)MQTTS:消息队列遥测传输安全协议(MessageQueuingTelemetryTransportSecure)NB-IoT:基于蜂窝的窄带物联网(NarrowBand—InternetofThings)PON:无源光网络(PassiveOpticalNetwork)SDH:同步数字系列(SynchronousDigitalHierarchy)SDK:软件开发工具包(SoftwareDevelopmentKit)SDN:软件定义网络(SoftwareDefinedNetwork)SIM:用户识别模块(SubscriberIdentityModule)SNMP:简单网络管理协议(SimpleNetworkManagementProtocol)SQL:结构化查询语言(StructuredQueryLanguage)TCP:传输控制协议(TransmissionControlProtocol)TLS:传输层安全性协议(TransportLayerSecurity)UDP:用户数据报协议(UserDatagramProtocol)WAPI:无线局域网鉴别和保密基础结构(WirelessLANAuthenticationandPrivacyInfrastruc-ture)3智蕊城市设备联接管理与服务平台安全管理运维管理智蕊城市设备联接管理与服务平台安全管理运维管理5平台总体框架5.1概述智慧城市设备联接管理与服务平台(以下简称“平台”)为智慧城市各行业设备提供统一的联接管理功能,为智慧城市行业应用提供数据、服务、可视化等支撑能力,与其他平台保持互联互通和交互协作,满足智慧城市对设备联接管理与服务的需求。5.2总体框架平台总体框架见图1。行业应用安防应急环保消防…可视化层Da接口空问可视化Da接口设备可视化业务可视化Da接口*服务层数据层物联层数据服务数据汇聚感知与执行边缘管理应用服务数据存储数据建模开发服务数据转换数据管理数据交换+设备数据上报有线传输平台命令下发窄带无线传输设备数据上报有线传输平台命令下发窄带无线传输宽带无线传输传感网络管理感知管理边缘决策物联管理设备联接设备管理设备监控告憋设备规则引擎Dd接口终端网关其他政务云平分.Dr接口视频既控天数据一不亚信息服平台._平台__务支撞平台约束的核心范围。注2:设备、行业应用、其他平台(虚线框内容)是平台的相关内容,不是本文件约束的范围。图1智慧城市设备联接管理与服务平台总体框架描述如下:a)物联层:提供物联管理、边缘管理、通信传输、感知与执行等设备接入与管理能力;e)运维管理:提供平台日常运维、监控告警、事件处理、运维统计等运维管理能力;4f)安全管理:提供平台自身、设备接入、平台对外服务的安全管理能力;g)平台接口:包括平台与设备的接口(Dd接口)、平台与行业应用的接口(Da接口)、平台与其他平台的接口(Dr接口)。6平台功能要求6.1物联层设备联接功能包括接入管理、设备鉴权、负载均衡、长连接和短连接等,功能要求分别规定如下。a)接入管理功能要求:1)应支持设备直接接入、边缘网关接入、第三方系统接入等多种接入方式;2)应支持有线宽带、移动通信网、NB-IoT及其他无线接入等多种网络接入方式;3)应支持HTTP/HTTPS、MQTT/MQTTS、LwM2M/CoAP等多种协议接入方式;4)应支持SDK、API等多种应用接入方式;5)应提供支持多操作系统和多语言的设备接入SDK开发工具。b)设备鉴权功能要求:1)应支持对接入平台的设备进行鉴权认证,确定终端设备的有效身份,认证成功后下发内部唯一标识到设备;2)应具备一机一密的设备认证机制,生成密码要素应包括但不限于设备编号、厂商代号、设c)负载均衡功能要求:1)应提供分布式消息中间件,平台支持根据设备接入协议设置分布式消息中间件对应主题,形成物联接入设备协议与所述主题的映射关系;2)应支持设备数据负载均衡,平台支持根据不同负载均衡策略,将设备数据转发至后续的数据处理模块d)应支持长连接和短连接等多种连接方式。设备管理功能包括设备注册、设备注销、设备信息查询、设备变更管理、设备升级管理和设备群组管理等,功能要求分别规定如下。a)设备注册功能要求:1)应支持单个设备注册或批量设备注册,并分配内部唯一设备标识,且内部设备标识与设备编码应建立关联关系;2)应支持设备信息的注册,包括但不限于设备名称、设备用户、设备厂商、设备位置、设备类3)应支持设备参数配置,并确保平台与设备配置信息同步。b)设备注销功能要求:1)应支持单个或批量设备注销;2)设备注销后,应基于时限要求保留设备的历史信息。5c)设备信息查询功能要求:1)应支持设备信息的查询,包括但不限于设备名称、设备用户、设备厂商、设备位置、设备类2)应支持设备运行信息的查询,包括但不限于配置参数、历史命令、在线记录、运行状态等;3)应支持查询指定设备采集的信息;4)应支持对具有空间位置属性的设备,提供基于地图服务的空间查询方式。d)设备变更管理功能要求:1)应支持设备信息的变更,包括但不限于设备名称、设备用户、设备厂商、设备位置、设备类2)应支持设备配置参数的变更,可指定设备配置参数保存策略,并支持人工修改。e)设备升级功能要求:1)应为设备软件升级提供支持;2)应支持设备远程升级,提供版本更新迭代和管理能力;3)应支持批量升级、群组升级、时间策略升级、并发数升级等升级策略;4)应支持服务端决策升级、终端决策升级、协商升级等升级模式。f)应支持设备群组管理功能,支持基于群组的用户赋权、订阅和通知。g)针对通过蜂窝网络连接的设备,应支持设备的SIM卡管理,辅助故障定位,实现终端故障监控和远程管理。备故障诊断等,功能要求分别规定如下。a)设备状态监控功能应支持设备状态的实时监控。b)设备告警管理功能要求:1)应支持告警类型管理,并在设备配置文件中定义;2)设备告警时应向平台提供告警信息,包括但不限于告警事件名称、告警事件类型、告警事3)当收到设备告警信息,平台可主动上报给上层应用,支持告警的查看和管理,并定位告警位置和区域;4)应支持根据告警事件性质与设备重要程度划定告警事件等级,为多项事件同时告警处置提供优先级参考;5)应支持告警过滤;6)应支持设备告警记录,包括但不限于设备的告警类型、告警原因、告警开始时间、告警持续时间、告警处置人员、告警处置结果等信息;7)应支持告警解除,告警解除后设备状态恢复为正常状态。c)设备故障诊断功能要求:1)应支持设备在平台的注册情况、电源电量、数据传输量、运行状态的分析;2)应支持对设备进行远程复位或升级;3)应实现设备运行日志的分析,包括但不限于设备的运行时间情况、设备的告警信息、设备与平台的交互时间等。6设备规则引擎功能包括规则定义、规则管理和规则调用等,功能要求分别规定如下。a)规则定义功能应支持预置定义或定制开发的规则场景以及规则内容定义,包括但不限于规则1)支持物联层中物联管理模块的规则定义,包括但不限于设备在线/离线状态判定规则、设备正常/故障状态判定规则、设备故障诊断方式的规则、设备告警之后平台的响应规则、设2)支持物联层中边缘管理模块的规则定义,包括但不限于传感网络拓扑重组规则、节点黑白名单定义规则、设备加入鉴权规则、感知网络的故障分析与排查规则等;3)支持物联层中通信传输模块的规则定义,包括但不限于数据收发路由规则、数据隔离规4)支持物联层中传输执行模块的规则定义,包括但不限于感知设备数据上报规则、感知设备状态上报规则、多类感知数据上报机制、数据上报冲突避免规则、指令优先级的定义规则、指令权限的划分规则等;5)支持其他用户自定义规则的制定。b)规则管理功能要求:1)应支持对现有规则的修改、删除和查询等;2)应支持规则管理流程的制定;3)应支持规则与设备、应用、告警等绑定,满足规则条件时,规则可以自动化的执行响应4)应支持将阈值超限、范围超限、位置跟踪等事件,作为规则引擎输入条件,并关联对应的处理动作;5)应支持自定义触发条件,特定条件的事件告警自动推送给应用。c)规则调用功能要求:1)应支持规则调用前进行规则判断,即判断设备当前相关状态与相关的规则是否满足相应条件,满足条件后进行规则调用;2)应支持需要提供规则调用所需的阈值、范围等作为规则引擎输入条件,保证平台对相应场景的规则响应;3)应支持在线增加并管理规则触发器,在线设置触发器名称和触发条件,并提供至少一种触发报警方式,包括但不限于邮箱接收、短信接收、第三方服务器接收等;4)应支持基于预设规则的设备联动触发,实现多设备的协同反应;5)应支持基于规则引擎的业务流自定义,实现数据个性化流转和处理。有线传输功能要求如下:a)应支持不同场景对传输要求的能力,包括但不限于核心网、IP城域网、分组传送网等应用范围;b)应支持不同的网络接入能力,包括但不限于以太网、SDH、PON等;c)应支持根据不同场景选用不同时延等级的网络;7d)应支持QoS调度,根据不同要求进行区别传输转发,包括区分控制信令、采集数据等报文;e)应支持高精度时间同步能力,并可接入主/备用时间同步源;f)应支持不受设备厂家限制的SDN功能。宽带无线在物联网中承担大容量数据传送网络的功能。宽带无线传输功能要求如下:a)应支持无线网络持续演进,如5G以及后续演进;b)应支持不同流量等级的区分;c)应支持网络切片,根据服务等级协议为特定业务配置用户数、QoS、带宽等参数;d)应支持无线接入点的传输接入。窄带无线在物联网中承担低功耗、小数据场景的数据传输网络功能。窄带无线传输功能要求如下:a)应支持不同场景的窄带传输方式;b)应支持后续演进网络中窄带无线可与宽带共组网能力;c)应支持多个租户、多个用户同时接入,并且保证数据隔离;d)应支持满足低功耗场景的需求,如报文唤醒等;e)应支持不同来源的不同协议间的数据转换;f)应支持SNMP、CMIP、CORBA等多种网络管理协议,并支持不同协议间的切换,满足不同场景对窄带通信网络的需要。传感网络管理功能要求如下:a)应支持无线和有线两种方式,有线传感网络包括但不限于电力线载波、CAN线路等,无线传感网络包括但不限于蓝牙、WAPI、RF、ZigBee(一种低速短距离传输的无线网络协议)等;b)应支持拓扑的自动改变功能;c)应支持数据的自动路由功能;d)应支持传感的自动发现功能;e)应支持用户的远程访问功能;f)应支持节点黑白名单功能;g)应支持设备加入鉴权功能;h)应支持连接信道的动态分配功能;i)应支持物联网关的参数配置功能、定位的上报及查询功能;j)应支持传感网络遭外力破坏后的重组自愈功能;k)应支持自主完成指定任务的分布式智能化网络系统;1)应支持微型传感器实时获取监测对象的数据。感知管理功能要求如下:a)应支持设备在边缘网络中的加入、退出和变更的感知;8b)应支持设备状态的感知;c)应支持感知传感网络的拓扑变化、线路状态变化,并能实时刷新路由;d)应支持感知上行网络的变化,根据网络变化能对数据进行本地化保存或处理及重传传感数据;e)应支持设备的移动性管理,并能实时刷新设备位置信息;f)应支持感知网络的规模变化与扩展状况,更新感知网络整体信息;g)应支持对感知网络资源的参数配置;h)应支持对感知网络的实时运行性能、服务质量状态等资源的监视;i)应支持实时对感知网络的远程控制;j)应支持对同类型感知网络的按需调度;k)应支持对感知网络的测试、故障分析与排查功能。边缘决策功能要求如下:a)应支持在网络中断或关闭状态下设备的自我管理和本地控制功能;b)应支持设备的规则调度与处理功能;c)应支持感知网络被入侵状况下的告警与设备自动切断功能;d)应支持特定场景下部分感知数据和设备状态数据的边缘处理功能。设备数据上报功能要求如下:a)应支持设备状态数据和设备监测数据的上报;b)应支持基于规则引擎中定义的规则进行数据上报,包括但不限于基于设定的周期、事件触发等;c)平台接收到设备上报数据后,应及时向设备返回响应消息;d)应支持解析设备上报数据,并基于配置策略(包括转发、保存、透传等)发送至行业应用;e)应支持同时存在多条数据采集路径;f)应支持感知设备采集数据本地存储,以降低中心节点的存储资源压力;g)应支持在数据采集时,设备故障时空白数据段的标记填充功能;h)应支持因设备故障发生替换时同点采集数据的匹配功能;i)应支持同时进行多点数据采集与上传功能;j)当设备上报数据后没有收到平台的响应消息时,应能重新上报数据;k)若超出设定的重传次数阈值,上报数据失败,应支持数据本地缓存,下一个上报周期上报;1)应支持单一感知设备多类感知数据同时进行数据上报;m)应支持不同优先级数据采集与上传。设备状态上报功能要求如下:a)应支持可配置定时发送心跳;b)应支持上报一段时间内的设备状态;c)应支持其他平台当前状态信息的上报;9d)应支持设备按照规则引擎中定义的规则进行状态上报,如一定频率或事件触发进行状态上报。命令下发功能要求如下:a)应支持对平台命令进行定义、管理和命令下发过程的管理等;b)命令定义的内容应包括但不限于命令名称、命令类型、命令编码、命令关联设备、对应操作等;d)应支持对命令关联设备发送命令,并能够监控命令执行的过程;e)应支持行业应用通过平台开放的接口对设备进行管理和控制;f)应支持行业应用通过平台下发设备控制命令,支持立即下发、缓存下发及批量命令下发能力;g)应支持通过管理门户或API进行远程设备命令下发,如开启、关闭等,实现对设备的手动远程控制;h)应支持基于规则引擎远程开启或关闭设备;i)应支持平台命令集的合并与扩充;j)应支持对命令集中的命令优先级和权限的划分,具体划分规则可在规则引擎中进行定义;k)命令下发的对象范围包括但不限于平台联接管理的设备和其他平台;1)命令下发规则应在规则引擎中定义,其传输的途径参照通信传输中定义的传输途径。6.2数据层数据汇聚功能要求如下:a)应支持多种数据源的读取和写入操作,包括但不限于文件、数据库、web服务等;b)应支持对数据集成任务的管理、调度、监控、异常恢复等操作;c)应支持按照任务触发规则来调度数据集成任务;d)应支持多种可靠数据传输通道,实现不间断监听数据通道中的数据;e)应支持数据源管理、连接测试等功能;f)应支持异构数据源之间的数据同步功能;g)应支持数据在线汇聚、统计功能。平台应对采集到的数据及时进行存储,用于后续各类应用的查询、加工和分享。数据存储功能要求如下:a)应支持设备上报的数据直接透传给应用处理,或数据在平台内存储,存储周期可以配置;b)应支持多种存储方式,包括但不限于对象存储、列式存储、云存储、分布式数据库存储;c)应支持数据缓存处理,包括用户和应用的权限数据、资源订阅数据等存储;d)应支持数据存储节点和组件的动态伸缩;e)应支持多租户环境下的存储空间配额管理功能;f)应采用国家密码管理主管部门鉴定的密码算法,采用多重密钥保护机制对数据进行存储加密保护;g)应支持文件级细粒度安全存储,可单独设置文件的密级、加密算法、加密密钥等;h)应支持数据冗余多节点可靠存储,支持单节点故障业务不中断,保证平台业务数据存储规模变更时的可靠性;i)应支持数据备份和恢复。数据转换功能要求如下:a)应支持异构数据转换成统一格式;b)应支持不同设备上报数据转换为标准格式数据;c)应支持数据转换规则定制和管理;d)应支持数据转换规则、任务等程序的统一调度与监控;e)应支持设备数据解析,并按照统一的监测数据模型进行转换;f)应支持数据转换前的保存、备份功能,保证转换过程中的数据完整性;g)应支持设备空间数据坐标系的统一;h)应支持特定数据格式和统一数据格式的双向转换。数据交换功能要求如下:a)应符合数据交换共享有关的法律法规和监管要求;b)应支持数据处理功能,包括但不限于数据压缩、数据加密和签名、数据填充、数据格式转换、坐标位置提取等;c)应支持实时数据交换、批量数据交换;d)应支持多种类型数据交换,包括但不限于文件、数据库、web服务等;e)应支持多种交换策略,包括但不限于点对点、交换共享、服务订阅等,提供自适应动态数据传输打包机制、消息确认和消息选择性重发机制;f)应支持对数据交换流程定义、规则定义等可视化配置与管理,支持对交换过程状态管理、监控、数据分析功能要求如下:a)应支持设备状态数据分析,包括但不限于设备分布区域统计、设备部署类别统计、设备运行状态及趋势分析、设备区域故障状况统计、设备历史故障状况分析、设备维护状况统计、设备故障恢复率分析等;b)应支持设备监测数据分析,包括但不限于设备监测密度分析、设备监测数据均值/极值统计、设备监测数据偏差分析、设备监测数据异常频率统计、设备监测数据趋势分析等。数据建模功能要求如下:a)应支持建立统一的物模型和监测数据模型;b)应支持数据模型版本管理;c)应支持数据模型的更新与扩展;d)应支持对数据模型的元数据进行增加、删除、修改、查询等操作。数据治理功能要求如下:a)应提供可靠的数据应用规范,支持数据应用流程管理、数据应用审核、数据应用发布等;b)应提供数据从产生到消亡的全周期管流程配置、数据责任流程配置和数据治理审核机制;c)应支持数据质量分析和预警,甄别数据优劣程度,对质量较差数据进行清理和长期不用数据进行清洗和归档;d)应支持通过预定的规则进行数据稽核,稽核发现的问题按照预定规则自动治理或者生成任务工单进行处理,并生成稽核报告;e)应支持对数据属性标签标注功能,包括但不限于单个和批量标注标签、标签的增加、删除和修改等;f)应支持数据血缘关系管理,可自动生成和维护数据血缘关系地图;整等;h)应支持数据资源目录动态管理,包括但不限于梳理、编制、审核、发布等;i)应支持对不完整数据、错误数据、重复数据进行统一标识、清洗对比、整合转换等。6.3服务层数据服务功能要求如下:a)应支持对数据进行服务化封装、管理与开放;b)应支持以服务的形式对上层应用提供数据资源;c)应支持数据发布管理,保障数据使用者通过权限管理实时获取数据服务;d)应支持提供模型构建、脚本开发、任务调度、流程开发与编排等开发工具;e)应支持提供可视化建模工具,构造数据库模式、建立数据库、构建表结构和表关系;f)应支持异构数据库之间同步,包括但不限于采用基于数据表、数据视图、自定义SQL等方式构建数据模型。应用服务功能包括门户服务、模型服务、公共服务等,功能要求分别规定如下。a)门户服务功能要求:1)应支持移动应用开发构建;2)应支持基础通信能力集成,包括但不限于即时消息、语音呼叫、视频、邮件等;3)应支持第三方专业性服务(如短信服务、支付服务等),供行业应用使用。b)模型服务功能要求:1)应提供标准的物联网关集成接口;2)应支持批量管理设备实例的能力,包括但不限于批量更新设备实例、批量删除设备实例、批量注册、批量禁用、批量激活设备的能力;3)应支持配置设备的触发规则,包括但不限于启动或禁用触发器、设置触发器有效期、配置触发器规则参数等;4)应支持对平台的应用、用户、设备数据进行管理和关联绑定操作,并提供群组管理和批操作;5)应支持对同类模型设备批量添加共性的数据。c)公共服务功能要求:1)应支持公共组件通过服务化接口方式提供给行业应用使用,包括但不限于空间服务、信息服务、用户管理服务、账号管理服务、权限管理服务、认证授权服务、审计服务、服务管理等;3)应提供数据分析、模型配置、质量管理、运行监控等服务;4)应提供面向使用者的统一用户信息管理服务;5)应提供统一的账号管理服务,能够兼容已有账号管理系统;6)应提供基于组织或角色的权限管理服务,支持权限信息同步给对应行业应用;7)应提供统一的身份认证和授权服务,用户身份认证应支持“账号+密码”、人脸识别、指纹识别等多种认证方式;8)应提供事前预警,对登录模式、访问时间、操作行为、访问习惯和访问关系中出现的异常行为进行监控和预警;9)应支持对身份管理、访问行为和运维管理等进行全方位的合规审计;10)应提供服务管理功能,包括但不限于服务注册、服务发现、服务调用、服务编排、服务治理等;11)应提供服务生存周期管理,包括但不限于服务发布、申请、审批、交付、管理、监控、撤销等。开发服务功能包括开发功能、测试功能、发布功能和监控功能等,功能要求分别规定如下。a)开发功能宜符合以下要求:1)提供相应的开发工具,包括但不限于在线编排、开发模板、代码编译与测试、开发程序打包工具等;2)提供API开放管理、可视化组件等服务;4)提供软件服务化封装;5)支持应用项目管理、代码托管等。b)测试功能宜符合以下要求:1)提供在线错误的检测和修正;2)支持设备与平台的数据传输与接收过程调试;3)支持对平台上注册的设备发送模拟数据,记录和查看发送日志;4)支持API在线调试,如添加请求参数和请求内容,并显示返回结果;5)提供可视化在线调试工具,包括但不限于数据模拟器、地图数据模拟器、API调试工具等;6)提供沙箱环境,用于在线测试运行新开发的应用;7)测试环境支持物理机部署、虚拟化部署、云部署,支持集中式部署和分布式部署,支持服务器环境配置及核查。c)发布功能宜符合以下要求:1)支持应用的持续集成、在线打包发布和自动部署;2)提供应用运行环境;3)支持服务构件的热加载(即插即用)。d)支持实时监控应用的运行状态和资源使用情况。集成服务功能包括应用集成、消息集成等,功能要求分别规定如下。a)应用集成功能要求:1)应支持在线创建设备关联的轻应用,支持对应用进行预览发布和公开访问,支持对应用进2)应支持在线对第三方开发平台进行服务器配置,设置推送的地址和数据内容,并支持相关消息进行加解密接入验证等操作;4)应支持对应用服务进行路由管理、流控管理、授权管理、运维管理等操作;5)应支持通过服务的形式将数据库对外开放使用。b)消息集成功能要求:2)应提供消息的发布、订阅、存储、跨数据中心路由和跨云传输,支持安全接入和轨迹跟踪;3)应支持多种发布订阅模式;4)应提供可靠的消息传输通道;5)应提供自动化的运维可视和告警机制。6.4可视化层空间可视化是将基于地理信息数据的数字空间通过可视化的形式进行呈现,空间可视化功能要求如下:a)应支持基础地理信息要素数据的显示,包括但不限于区域范围内的卫星影像、行政区划、道路、水系等;b)应支持多种显示方式,包括但不限于二三维一体化显示、地上地下一体化显示、宏微观一体化显示及无缝切换显示;c)应支持加载地理信息数据和城市信息模型;d)应支持加载建筑信息模型,支持模型内部漫游及设备状态查看;e)应支持城市地下基础设施效果呈现,包括但不限于地下综合管廊、地下隐蔽工程、地下建筑结构体等,对特定区域进行地表剥离,显示地表以下空间关系。设备可视化是将设备的属性、状态、功能等通过可视化的形式进行呈现。设备可视化功能要求如下:a)应支持对设备全生存周期数据的综合呈现;b)应支持设备与其周边场景融合一体化呈现;c)应支持设备状态、效能状态、预警状态、内部结构等可视化呈现;d)应支持设备报警后自动推送报警信息及报警现场照片,进行一体化推送呈现;e)应支持设备指标数据的不同方式展示,包括但不限于空间标牌方式、空间飞线方式等;f)应支持设备模型动画展示设备状态的能力,如开关的旋转、车轮的转动等;g)应支持将设备状态、报警状态等信息统一推送到移动端、桌面终端、大屏幕等多终端融合呈现;h)应支持将设备根据空间位置进行区域化管理、空间位置查找;i)应支持模型透视,实现关键部件查看。业务可视化是将用户的业务数据、业务逻辑、工作流程等结合空间和设备进行可视化呈现。业务可视化功能要求如下:a)应支持与指定业务场景相关联的多类设备监测数据、报警数据的管理与呈现;b)应支持对业务管辖区域、业务责任人等业务管理数据的呈现与推送;c)应支持业务与设备的远程联动控制与可视化呈现;d)应支持与指定业务相关联的设备维护、事件告警等业务处置流程的可视化呈现;e)应支持通过移动端、桌面终端、大屏幕等多种方式实现业务信息的可视化呈现。6.5运维管理6.5.1平台日常运维平台配置管理功能要求如下:a)应根据业务需求配置平台运行管理参数,包括但不限于日志管理、监控告警、校时管理、版本管b)应支持资源模型和资源属性的自定义配置;c)应支持配置统计查看,进行配置数据及配置关系展示。平台资源管理功能应支持对平台使用的硬件资源、软件资源、数据资源等进行管理,掌握资源现状和配置信息。平台升级维护功能要求如下:a)应按需完成平台升级维护;b)应支持平滑升级,保证数据不丢失;c)应支持记录升级维护的日志;d)若升级不成功,平台应保持可用状态或恢复升级前状态。6.5.2平台监控告警平台监控管理功能要求如下。a)应支持监控类型管理,同时需在设备配置文件中定义。b)应支持对平台运行状态监控管理:1)应实时监控平台自身运行的基本信息,包括但不限于平台运行状态监控、用户行为监测、信息监控等;2)应支持第三方监控系统对接。c)应支持对自身状态进行实时查看:1)应支持对平台运行环境进行日常化巡检和实时监测;2)应支持平台运行环境资源状态的可视化显示。平台告警管理功能要求如下:a)应支持在监控指标超出阈值时提出告警,并提供告警过滤功能;b)告警信息应包括但不限于告警标题、告警来源、告警发生时间、告警地点、告警描述和告警级别等;d)应支持告警分级分域上报,用户应按权限查看告警信息;e)应支持告警解除,在告警解除后,平台运行环境状态恢复为正常状态;f)应提供故障报告生成、故障跟踪、故障处理、故障关闭、故障复盘等功能;g)应支持告警信息的批量处理,并可对历史告警处理进行追溯。6.5.3平台事件处理平台事件处理功能要求如下:a)应支持事件分级分类;c)应支持对事件工单的各个节点设置触发动作,如邮件、短信、调用外部接口等;d)应支持事件工单多种任务分派方式,包括发起人指定、自动分配、主动认领等,支持任务的干预和改派;e)应支持运维人员通过移动智能终端对相应事件工单进行查看、处理、审批、反馈等操作,并同步上传至运维管理系统;f)应提供事件处理评估功能。6.5.4平台运维统计平台运维统计功能要求如下:a)应提供多维度的平台运维统计功能,包括但不限于设备统计、用户统计、资源统计、告警统计、b)应支持多种形式展示运维统计结果,包括但不限于数据报表、可视化图表、地图展示等;c)应支持运维数据对外开放,为可视化页面和自定义报表的开发提供数据资源,并可适配多终端屏幕显示。6.6安全管理平台在安全管理方面应符合GB/T22239—2019、GB/T22080—2016、GB35114—2017等的要求。7平台接口要求7.1接口大类根据平台业务交互对象,平台定义了如下外部接口:a)Dd接口是平台与设备之间接口,提供设备与平台之间控制信息传递和感知数据传输;b)Da接口是平台与行业应用之间接口,提供数据和服务能力支撑以及适配接入管理;c)Dr接口是平台与其他平台之间接口,提供数据共享与交换能力。7.2接口总体要求平台接口总体要求如下:a)平台接口的实现应与实现技术无关,接口内部实现技术变更不应导致服务接口变化;b)平台接口应符合统一的数据格式与交互参数,同时应提供防错、容错、合法性校验等机制;c)平台接口服务端应对客户端做身份认证,应对敏感数据做加密;d)平台不应支持可绕过系统安全机制访问平台或数据的接口;e)平台接口访问操作应有记录日志,日志内容应符合审计要求。7.3Dd接口要求7.3.1接口子类设备消息接口设备消息接口清单见表1,接口示例见附录A中的A.1。表1设备消息接口清单编号接口名称接口方向接口描述1设备消息接收设备发送至平台设备调用此接口将设备消息数据上报给平台2平台消息下发平台发送至设备平台模块调用此接口下发自定义格式的数据给设备设备命令接口设备命令接口清单见表2,接口示例见A.2。表2设备命令接口清单编号接口名称接口方向接口描述1平台命令下发平台发送至设备平台模块调用此接口向设备下发设备控制命令。平台下发命令后,需要设备及时将命令的执行结果返回给平台,如果平台没有接收设备响应,平台会认为命令执行超时设备属性接口设备属性接口清单见表3,接口示例见A.3。表3设备属性接口清单编号接口名称接口方向接口描述1终端装置属性接收设备发送至平台用于终端装置按物模型中定义的内容将属性数据上报给平台2批量终端装置属性接收设备发送至平台用于批量设备上报属性数据给平台,网关设备可以用此接口同时上报多个子设备的属性数据3设备影子数据获取设备发送至平台用于设备向平台获取设备影子数据。设备影子是一个数据结构定义,用于存储设备上报状态、应用程序期望状态信息,当设备离线之后再次上线,将主动向平台获取设备影子数据4设备属性设置平台发送至设备平台模块可调用此接口设置指定设备的属性数据。设备收到属性设置请求后,需要将执行结果返回给平台,如果设备没回响应平台会认为属性设置请求执行超时5设备属性查询平台发送至设备平台模块可调用此接口查询设备的属性数据。设备收到属性查询请求后,需要将设备的属性数据返回给平台,如果设备没回响应平台会认为属性查询请求执行超时设备事件接口清单见表4,接口示例见A.4。表4设备事件接口清单编号接口名称接口方向接口描述1设备事件接收设备发送至平台设备调用此接口将设备按物模型定义的格式将事件数据上报给平台。设备事件类型,包括但不限于设备上报升级状态、设备上报软固件版本、网关更新子设备状态、网关同步子设备信息等2平台事件下发平台发送至设备平台按物模型中定义的事件格式下发事件给设备。设备事 件类型,包括但不限于平台通知网关新增子设备、平台通知网关删除子设备、平台获取版本信息、平台下发固件升级、平台下发软件升级等7.3.2接口技术要求Dd接口技术要求如下:a)接口协议应符合GB/T35319—2017中6.10规定的要求;b)应支持设备直联接入和通过网关接入:1)设备直联接入:针对已实现TCP/IP协议栈的设备,可以直接与平台进行通信并对协议解2)通过网关接入:针对未实现TCP/IP协议栈的设备,基于近场通信协议(如ZigBee、ZWave、蓝牙等)或非IP有线方式传输协议(如串口、并口等)的设备,先让设备接入到网c)应支持多种网络协议、传输协议、安全协议等,并且具备开放可扩展和向后兼容的能力;d)应支持有线和无线的接入方式,符合6.1.2通信传输要求;e)应支持主流的终端设备接入通信协议,包括但不限于:CoAP、MQTT/MQTTS、HTTP/HT-TPS、LwM2M、Modbus(一种串行通信协议)、BACnet、LonWorks及其他行业协议,支持UDP/TCP传输协议;f)应支持通过扩展协议插件实现私有或非标协议设备和应用的接入,支持上传、加载、卸载协议插件;g)应支持数据交互,采用TLS/DTLS加密协议传输,其中TCP方式接入的遵循TLS加密协议传输,UDP方式接入遵循DTLS加密协议接入;h)应支持选择对称和非对称加密方式。鉴权管理接口清单见表5,接口示例见附录B中的B.1。表5鉴权管理接口清单编号接口名称接口方向接口描述1鉴权行业应用发送至平台行业应用首次访问平台的接口时,需调用此接口获取访问令牌,完成接入认证。行业应用在平台的认证过期后,需调用此接口重新进行认证,才能继续访问平台的接口2刷新行业应用发送至平台访问令牌快过期时,行业应用通过调用此接口重新获取可用访问令牌,实现行业应用在访问令牌到期前,获取新的访问令牌设备管理接口清单见表6,接口示例见B.2。表6设备管理接口清单编号接口名称接口方向接口描述1注册设备行业应用发送至平台行业应用调用此接口在平台中注册一个设备,并获取设备ID和密码。仅在注册后设备才可以接入平台2修改设备信息行业应用发送至平台由行业应用发给平台的消息,行业应用调用此接口修改平台中指定设备的信息,如设备类型、厂商信息、位置信息等3删除设备行业应用发送至平台若设备不再需要使用,行业应用调用此接口删除平台中指定设备,删除后的设备可以重新注册回平台。若设备是网关,则应把网关下的终端装置都删除后,才能删除该设备表6设备管理接口清单(续)编号接口名称接口方向接口描述4查询单个设备信息行业应用发送至平台行业应用调用此接口查询平台中指定设备的详细信息。设备信息包括设备证书信息、固件信息、扩展信息、标签信息等内容5查询批量设备信息行业应用发送至平台行业应用调用此接口查询平台中设备的信息列表,根据给定的条件批量获取符合条件的设备信息列表6查询设备分组行业应用发送至平台行业应用调用此接口查询平台中设备分组信息设备服务接口清单见表7,接口示例见B.3。表7设备服务接口清单编号接口名称接口方向接口描述1查询设备服务能力行业应用发送至平台行业应用调用此接口查询设备定义的服务能力信息,包括设备可上报哪些服务属性数据,以及设备支持接收哪些命令等设备影子接口清单见表8,接口示例见B.4。表8设备影子接口清单编号接口名称接口方向接口描述1查询设备影子行业应用发送至平台行业应用调用此接口查看设备影子上的设备配置信息及最新的设备上报数据信息2修改设备影子行业应用发送至平台行业应用调用此接口修改设备影子信息,在设备影子上配置要下发给设备的配置信息。若设备处于离线或异常状态时,行业应用无法通过命令下发的方式向设备下发配置,此时可把要下发的配置设置到设备影子,当设备重新上线时,设备影子会把配置下发给设备。通过调用创建命令接口实现数据采集接口清单见表9,接口示例见B.5。表9数据采集接口清单编号接口名称接口方向接口描述查询设备历史数据行业应用发送至平台平台收到并保存设备的上报数据,行业应用要查看某个设备上报到平台的数据,可调用此接口查询获取2查询设备历史事件行业应用发送至平台平台收到并保存设备行为事件信息,行业应用要查看某个设备的历史事件信息,可调用此接口查询获取。事件信息包括但不限于设备的创建、上线、下线、删除、故障、维护等命令下发接口命令下发接口清单见表10,接口示例见B.6。表10命令下发接口清单编号接口名称接口方向接口描述1命令下发行业应用发送至平台行业应用调用此接口向指定设备下发命令,以实现对设备的同步控制。平台负责将命令以同步方式发送给设备,并将设备执行命令结果同步返回,如果设备没有响应,平台返回给行业应用超时订阅管理接口订阅管理接口清单见表11,接口示例见B.7。表11订阅管理接口清单编号接口名称接口方向接口描述1创建订阅行业应用发送至平台行业应用调用此接口订阅设备变更通知,当设备的业务信息发生变更时可以将变更信息推送给应用。订阅类型包括但不限于设备添加通知、设备删除通知、设备信息变化通知等2删除订阅行业应用发送至平台行业应用调用此接口删除平台中行业应用创建的订阅3修改订阅信息行业应用发送至平台行业应用调用此接口修改平台中某个订阅的配置信息4查询订阅列表行业应用发送至平台行业应用调用此接口查询平台中的订阅信息列表推送通知接口推送通知接口清单见表12,接口示例见B.8。表12推送通知接口清单编号接口名称接口方向接口描述1设备添加通知平台发送至行业应用行业应用订阅添加设备通知后,设备在平台添加时,平台调用此接口给行业应用推送设备添加的结果2设备删除通知平台发送至行业应用行业应用订阅设备删除通知后,设备被删除时,平台调用此接口给行业应用推送设备删除通知3设备信息变化通知平台发送至行业应用行业应用订阅设备信息变化通知后,设备信息发生变化时,平台调用此接口给应用推送设备信息变化通知7.4.2接口技术要求Da接口技术要求如下:a)接口协议应符合GB/T35319—2017中6.18规定的要求。b)应支持自定义的方式与行业应用对接;c)应具备开放可扩展和向后兼容的能力;d)提供给应用服务的数据交互采用应用层HTTPS协议传输,采用加密协议宜使用TLSv1.2、TLSv1.3;e)应支持HTTPS、MQTTS、DTLS+等多种安全协议;f)针对网络传输的用户重要数据,应支持通过设置完整性标签等进行完整性检测,其完整性受到破坏,能采取相应措施进行数据恢复;g)应支持在服务器端对所有来自不可信数据源的数据进行校验,拒绝任何未通过校验的数据。7.5.1接口引用Dr接口引用应符合其他平台定义的接口标准规范,Dr接口清单见附录C。7.5.2接口技术要求Dr接口技术要求如下:a)接口协议应符合GB/T35319—2017中6.16规定的要求;b)应提供针对异构数据接口提供适配接入管理;c)应提供数据库的接入;d)应支持身份管理,身份信息包含但不限于系统名称、系统IP、端口号、鉴权码等;e)应支持鉴权码管理,鉴权码应采用加密算法,保证外部系统接入的安全性;f)应支持数据共享与交换,实现系统与平台之间的互联互通。(资料性)A.1设备消息接口设备消息接收接口原型见表A.1。Dd接口示例设备消息接收接口原型请求原型上行:$/devices/{device_id}/sys/messages/up协议MQTT设备消息接收接口请求参数见表A.2。参数约束类型描述device_id可选String消息对应的最终目标设备可选String消息名称可选String消息的唯一标识必选String消息内容接口请求示例:Body:{"device_id":"40000012345",A.1.2平台消息下发平台消息下发接口原型见表A.3。表A.3平台消息下发接口原型请求原型下行:$/devices/{device_id}/sys/messages/down协议MQTT平台消息下发接口请求参数见表A.4。表A.4平台消息下发接口请求参数参数约束类型描述可选String消息对应的最终目标设备可选String消息名称可选String消息的唯一标识必选String消息内容接口请求示例:A.2设备命令接口A.2.1平台命令下发平台命令下发接口原型见表A.5。表A.5平台命令下发接口原型请求原型下行:$/devices/{device_id}/sys/commands/request_id={request_id}上行:$/devices/{device_id}/sys/commands/response/request_id={request_id}协议MQTT平台命令下发接口下行请求参数见表A.6。表A.6平台命令下发接口下行请求参数参数约束类型描述可选命令对应的目标设备ID可选设备的服务ID可选设备命令名称可选设备命令的执行参数平台命令下发接口上行请求参数见表A.7。表A.7平台命令下发接口上行请求参数参数约束类型描述result_code可选标识命令的执行结果response_name可选String命令的响应名称Paras可选Object命令的响应参数平台命令下发接口下行请求示例:Body:{平台命令下发接口上行请求示例:Body:{"response_name":"COMMAND_RESPONSE",A.3设备属性接口A.3.1终端装置属性接收终端装置属性接收接口原型见表A.8。表A.8终端装置属性接收接口原型请求原型上行:$/devices/{device_id}/sys/properties/report协议MQTT终端装置属性接收接口参数说明见表A.9。参数约束类型描述device_id可选String属性设置对应的目标设备ID必选List<ServiceProperty>设备服务数据列表ServiceProperty结构定义见表A.10。参数约束类型描述service_id必选String设备的服务IDproperties必选Object设备服务的属性列表接口请求数据格式:Body:{"device_id":"40000012345",批量终端装置属性接收接口原型见表A.11。表A.11批量终端装置属性接收接口原型请求原型上行:$/devices/sys/gateway/sub_devices/properties/report协议批量终端装置属性接收接口参数说明见表A.12。参数约束类型描述必选List<DeviceProperty>设备数据参数约束类型描述device_id必选String目标设备ID必选List<ServiceProperty>设备服务数据列表接口请求示例:Body:{"device_id":"42aa08设备影子数据获取接口原型见表A.14。表A.14设备影子数据获取接口原型请求原型上行:$/devices/{device_id}/sys/shadow/get/request_id={request_id}下行:$/devices/{device_id}/sys/shadow/get/response/request_id={request_id}协议MQTT设备影子数据获取接口上行请求参数见表A.15。表A.15设备影子数据获取接口上行请求参数参数约束类型描述可选需要获取设备影子的目标设备ID可选需要获取设备影子的设备服务ID,不携带时查询所有服务ID的设备影子数据设备影子数据获取接口下行请求参数见表A.16。表A.16设备影子数据获取接口下行请求参数参数约束类型描述device_id必选String设备影子的目标设备ID可选List<ShadowData>服务影子数据ShadowData结构定义见表A.17。参数约束类型描述service_id必选String设备的服务IDdesired可选PropertiesData设备影子desired区的属性列表reported可选PropertiesData设备影子reported区的属性列表PropertiesData结构定义见表A.18。参数约束类型描述properties必选Object设备服务的属性列表event_time可选String设备属性数据的UTC时间(格式:yyyyMMddTHHmmssZ)设备影子数据获取接口设备上行请求示例:Body:{"device_id":"40000012345","service_id":"Temperature"}设备影子数据获取接口下行请求示例:"service_id":"WaterMeter","desired":{"properties":{"temperature":"60"}},"reported":{"properties":{"temperature":"80"}}}]}设备属性设置接口原型见表A.19。表A.19设备属性设置接口原型请求原型下行:$/devices/{dev上行:$/devices/{device_id}/sys/pro协议设备属性设置接口下行请求参数见表A.20。表A.20设备属性设置接口下行请求参数参数约束类型描述可选属性设置对应的目标设备ID必选List<ServiceProperty>设备服务数据列表设备属性设置接口上行请求参数见表A.21。表A.21设备属性设置接口上行请求参数参数约束类型描述result_code可选命令的执行结果result_desc可选String属性设置的响应描述设备属性设置接口下行请求数据格式:"service_id":"Temperature","properties":{"value":57}}]设备属性设置接口上行响应数据格式:"result_code":0,A.3.5设备属性查询设备属性查询接口原型见表A.22。请求原型下行:$/devices/{dev上行:$/devices/{device_id}/sys/pro协议设备属性查询接口下行请求参数见表A.23。参数约束类型描述device_id可选String属性设置对应的目标设备ID可选String设备的服务ID设备属性查询接口上行请求参数见表A.24。表A.24设备属性查询接口上行请求参数参数约束类型描述services可选List<ServiceProperty>设备服务数据列表设备属性查询接口下行请求示例:Body:{"device_id":"40000012345",设备属性查询接口上行请求示例:Body:{A.4设备事件接口A.4.1设备事件接收设备事件接收接口原型见表A.25。表A.25设备事件接收接口原型请求原型上行:$/devices/{device_id}/sys/events/up协议MQTT设备事件接收接口参数说明见表A.26。表A.26设备事件接收接口参数说明参数约束类型描述可选属性设置对应的目标设备ID必选List<ServiceEvent>事件服务列表ServiceEvent结构定义见表A.27。参数约束类型描述必选设备的事件ID必选设备事件类型可选设备采集数据UTC时间(格式:yyyyMMddTHHmmssZ)必选事件参数对象接口请求数据格式:'event_type":"upgrade_progress_report""description":"upgradeprocessing"}}]}A.4.2平台事件下发平台事件下发接口原型见表A.28。表A.28平台事件下发接口原型请求原型下行:$/devices/{device_id}/sys/events/down协议MQTT平台事件下发接口参数说明见表A.29。表A.29平台事件下发接口参数说明参数约束类型描述device_id可选String属性设置对应的目标设备ID必选List<ServiceEvent>事件服务列表接口请求数据格式:Body:{"service_id":"service_id","event_type":"firmware_upgrade","paras":{"url":/firmwarefiles/cald95477lae6le5098c7f83","file_size":81362928}}](资料性)B.1鉴权管理接口B.1.1鉴权鉴权接口原型见表B.1。请求原型http://ip:port/iot/1.0/login协议http/https请求方法POST鉴权接口请求参数见表B.2。参数约束类型描述必选String应用的身份标识,用于唯一标识一个应用secret必选String应用的密码,与appld对应,用于登录访问平台鉴权接口响应参数见表B.3。表B.3鉴权接口响应参数参数约束类型描述tokenType必选String访问令牌的类型expiresIn必选平台生成并返回访问令牌的有效时间,单位为秒accessToken必选String访问令牌,访问物联网平台API接口的凭证refreshToken必选String用来刷新访问令牌接口请求示例:接口响应示例:"accessToken":"RK5rBBk3deEmVIJ6hYDavtxwqRadirBpsHoi4rKEw8fzm4tVLM%3d","refreshToken":"rr9pf3ooYmc%2bkYnSOILemlMaPIxzrcSzdBIxHTzwrMmec%3d"刷新接口原型见表B.4。表B.4刷新接口原型请求原型http://ip:port/iot/1.0/refreshToken协议http/https请求方法POST刷新接口请求参数见表B.5。参数约束类型描述必选String应用的身份标识,用于唯一标识一个应用Secret必选String应用的密码,与appld对应,用于登录访问平台refreshToken必选String刷新token,用来获取一个新的accessToken刷新接口响应参数见表B.6。表B.6刷新接口响应参数参数约束类型描述必选访问令牌的类型必选平台生成并返回访问令牌的有效时间,单位为秒必选访问令牌,访问物联网平台API接口的凭证必选用来刷新访问令牌接口请求示例:Body:{"appId":"jeQZltU8iKgFFoWOF5SGZka","secret":"35a250c50dcd481d04efdc3c","refreshToken":"rr9pf3ooYmc%2bkYnSOILemlMaPIxzrcSzdBIxHTzwrMmec%3d"接口响应示例:Body:{"accessToken":"RK5rBBk3deEmVIJ6hYDavtxwqRadirBpsHoi4rKEw8fzm4tVLM%3d","refreshToken":"rr9pf3ooYmc%2bkYnSOB.2设备管理接口B.2.1注册设备注册设备接口原型见表B.7。表B.7注册设备接口原型请求原型http://ip:port/iot/1.0/devices协议http/https请求方法POST注册设备接口请求参数见表B.8。表B.8注册设备接口请求参数参数约束类型描述Authorization必选String访问平台的认证信息,值为访问令牌timestamp必选String毫秒时间戳appld必选String应用的身份标识,用于唯一标识一个应用devicelnfo必选DeviceInfo设备信息。具体参见DeviceInfo结构体Devicelnfo结构体说明见表B.9。表B.9Devicelnfo结构体说明参数约束类型描述nodeld必选String设备唯一标识码,通常为设备物理编码,例如IMEI或者MAC地址name可选String设备名称manufacturerld可选String厂商ID,唯一标识一个厂商deviceType可选String设备类型model可选String设备型号protocolType必选String注册设备接口响应参数见表B.10。表B.10注册设备接口响应参数参数约束类型描述必选在平台中的设备ID,在平台中唯一标识一个设备secret必选设备密码接口请求示例:POSThttps://ip:port/iot/1.0/devices?appld={appld)Header:{Body:{接口响应示例:"deviceld":"123123123123","secret":"A12asd234213ewelsdw123!"}B.2.2修改设备信息修改设备信息接口原型见表B.11。表B.11修改设备信息接口原型请求原型http://ip:port/iot/1.0/devices协议请求方法修改设备信息接口请求参数见表B.12。表B.12修改设备信息接口请求参数参数约束类型描述Authorization必选String访问IoT平台的认证信息,值为访问令牌timestamp必选String毫秒时间戳必选String应用的身份标识,用于唯一标识一个应用deviceld必选String在平台中的设备ID,在平台中唯一标识一个设备参数约束类型描述productld可选设备归属的产品ID,关联设备所属的产品模型name可选设备名称manufacturerld可选厂商ID,唯一标识一个厂商可选设备类型model可选设备型号protocolType可选mute可选设备状态可选设备描述接口请求示例:PUThttps://ip:port/iot/1.0/devices/{deviceld}?appId={appld}"timestamp":"1568383635245",Body:{接口响应示例:B.2.3删除设备删除设备接口原型见表B.13。表B.13删除设备接口原型请求原型http://ip:port/iot/1.0/devices协议http/https请求方法DELETE删除设备接口请求参数见表B.14。参数约束类型描述Authorization必选String访问IoT平台的认证信息,值为访问令牌表B.14删除设备接口请求参数(续)参数约束类型描述timestamp必选String毫秒时间戳deviceld必选String在平台中的设备ID,在平台中唯一标识一个设备可选String应用的身份标识,用于唯一标识一个应用可选Boolean是否级联删除,仅当设备下连接了非直连设备时生效接口请求示例:DELETEhttps://ip:port/iot/1.0/devices/{deviceld}?appId={appld}Header:{"timestamp":"1568383635245"Authorization":"17df4f628364d6d2b487212db8a34444794c8abd9954dec5d"接口响应示例:StatusCode:200查询单个设备信息接口原型见表B.15。请求原型http://ip:port/iot/1.0/devices协议请求方法查询单个设备信息接口请求参数见表B.16。表B.16查询单个设备信息接口请求参数参数约束类型描述Authorization必选String访问IoT平台的认证信息,值为访问令牌timestamp必选String毫秒时间戳可选String应用的身份标识,用于唯一标识一个应用deviceld可选String在平台中的设备ID,在平台中唯一标识一个设备查询单个设备信息接口响应参数见表B.17。表B.17查询单个设备信息接口响应参数参数约束类型描述必选在平台中的设备ID,在平台中唯一标识一个设备必选节点类型可选创建设备时间,使用UTC时间(格式:yyyyMMddTHHmmssZ)可选最后修改设备时间,使用UTC时间(格式:yyyyMMddTHHmmssZ)可选设备信息。具体参见Devicelnfo结构体接口请求示例:GEThttps://ip:port/iot/1.0/devices?deviceld={deviceld}&.appld={appld}Header:
温馨提示
- 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
- 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
- 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
- 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
- 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
- 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
- 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。
最新文档
- 数学学院校长聘用合同要点
- 医疗协会财务审计准则
- 山东省低速电动车广告宣传策略
- 艺术馆幕墙装饰施工协议
- 博物馆食堂使用规定
- 环保主题幼儿园园长聘用合同
- 年产1500套LED光电检测设备扩建项目可行性研究报告201×03
- 城市轨道项目招投标文件审查
- 休闲娱乐区车位购买协议范文
- 环保与清洁能源展览场地租赁合同
- module-5剑桥BEC商务英语-中级-课件-答案-词汇讲课教案
- 旅馆业设施布局与室内设计考核试卷
- 2024年消防知识竞赛考试题库300题(含答案)
- 2024中国船舶报社公开招聘采编人员1人高频难、易错点500题模拟试题附带答案详解
- 中图版2024-2025学年八年级地理上册期中卷含答案
- 室内装修投标方案(技术方案)
- 农业机械化在农业机械化作业中的应用考核试卷
- 喷漆安全管理制度
- 2024教师职业个人三年发展规划
- 山东科学技术出版社小学一年级上册综合实践活动教案
- 2024-2030年中国市政公用工程行业市场发展分析及发展潜力与投资研究报告
评论
0/150
提交评论