检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
构造请求 请求URI 请求URI由如下部分组成。 {URI-scheme}://{Endpoint}/{resource-path}?{query-string} 参数 说明 URI-scheme 传输请求的协议,当前所有API均采用HTTPS协议。 Endpoint 承载REST
注册设备(验证码方式) 接口说明 在设备接入物联网平台前,应用服务器需要调用此接口在物联网平台注册设备,并设置设备的唯一标识(如IMEI)。在设备接入物联网平台时携带设备唯一标识,完成设备的接入认证。 此注册设备接口适用于使用LWM2M/CoAP协议接入的设备,或者集成了AgentLite
什么是Profile(联通用户专用) 非联通用户请查看设备接入服务。 Profile(即产品模型)是用来描述一款产品中的设备“是什么”、“能做什么”以及“如何控制该设备”的文件。在物联网平台集成对接中需要先创建Profile,因为Profile里面定义了设备上报的数据和应用服务器下发的命令包含了哪些字段
SDK使用说明(联通用户专用) 非联通用户请查看设备接入服务。 SDK Demo总体架构 Demo代码是调用SDK接口的样例代码,包括初始化及各个接口调用,仅供开发者参考。 SDK提供JAVA方法调用物联网平台的API接口与平台通信。 消息推送回调使用JAVA代码实现回调接口,供平台推送消息给应用服务器时调用
SDK使用说明 非联通用户请查看设备接入服务。 SDK Demo总体架构 Demo代码是调用SDK接口的样例代码,包括初始化及各个接口调用,仅供开发者参考。 SDK提供Python方法调用物联网平台的API接口与平台通信。 消息推送回调使用Python代码实现回调接口,供平台推送消息给应用服务器时调用
增加设备组成员 接口说明 若需要把新增的设备或已有设备增加到某个设备组中,应用服务器可调用此接口向指定设备组添加设备成员。在向设备组添加设备前,建议通过“查询指定设备组”接口查询该设备组的当前设备数量及最大设备数量限制,确保设备组中还有足够的可添加成员数量。 注意事项 一个设备只能归属一个设备组
设备数据变化通知和批量设备数据变化通知的区别是什么? 设备数据变化通知和批量设备数据变化通知接口都是订阅设备的数据变化,只是封装的数据格式不一样。 例如:一款水表设备有Battery和Connectivity两种服务类型,每次上报数据都会上报这两个服务的数据。 如果订阅deviceDatachanged
删除子设备 若子设备不再需要接入物联网平台,应用服务器可调用此接口解绑网关下的子设备。 此功能通过设备命令下发接口向网关下发命令实现,具体删除子设备命令需网关提前实现(即网关收到什么命令会触发删除子设备的流程),并已在设备的Profile文件中定义。当网关收到平台下发的删除子设备命令时
注册设备通知 典型场景 第三方应用在物联网平台订阅了注册设备通知后(订阅的通知类型为deviceAdded),当第三方应用通过“注册直连设备”接口在平台注册设备时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了注册设备通知的第三方应用推送通知消息。 注意事项 应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址
设备数据变化通知 典型场景 第三方应用在物联网平台订阅了设备数据变化通知后(订阅的通知类型为deviceDataChanged),当设备上报单个服务属性数据时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备数据变化通知的第三方应用推送通知消息。 注意事项 应用在订阅平台业务数据时需要订阅接口描述中的指定回调地址
创建设备命令 接口说明 设备Profile文件中定义了物联网平台可向设备下发的命令,应用服务器可调用此接口向设备下发命令,配置或修改设备的服务属性,以实现对设备的控制。 物联网平台有两种命令下发机制: 立即下发:平台收到命令后立即下发给设备,保证实时性,不保证串行性。 缓存下发:平台收到命令后缓存起来
商用对接(联通用户专用) 非联通用户请查看设备接入服务。 当产品发布到产品中心后,我们在“开发中心”定义好的产品就可以在“设备管理服务”中使用了。由于开发中心所在的平台环境为测试环境,设备管理服务所在的平台环境为商用环境,两个环境的数据不能互通,已对接测试环境的设备/应用服务器要迁移商用环境
订阅后消息推送失败,例如提示503如何处理? 开发中心订阅调试时返回503: 原因可能有以下几种: 如果您是调用接口进行订阅,请从返回值判断订阅是否成功。仅当响应码为201 Created时表示调用成功,否则请根据错误码提示修改请求重新发送。 在开发中心调测时,可查看开发中心的消息跟踪
创建项目(联通用户专用) 非联通用户请查看设备接入服务。 项目是物联网平台提供物联网应用和设备的调测空间,您可以根据场景的不同创建不同项目空间分别调测。 创建项目时,物联网平台会分配一个应用ID(接口调用时参数名为appId)作为项目的唯一标识。若应用服务器需要调用物联网平台的API
应用快速接入(联通用户专用) 非联通用户请查看设备接入服务。 为了降低应用侧的开发难度、提升应用侧开发效率,物联网平台向应用侧开放了丰富的Restful API。本文档以Postman为例,模拟应用服务器以HTTPS协议为例接入物联网平台。 前提条件 已经注册华为云官方帐号,可点击注册页面完成注册
调用订阅接口时,回调地址如何获取? 以业务应用订阅设备数据变化通知为例,订阅和推送的流程如下: 应用服务器通过调用物联网平台的订阅接口订阅设备数据变化通知(携带回调地址和通知类型),物联网平台将业务应用的回调地址和订阅的通知类型存储到订阅列表中以便向业务应用推送设备数据变化消息。
设备数据变化通知 典型场景 第三方应用在物联网平台订阅了设备数据变化通知后(订阅的通知类型为deviceDataChanged),当设备上报单个服务属性数据时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了设备数据变化通知的第三方应用推送通知消息。 注意事项 1
设备影子(联通用户专用) 非联通用户请查看设备接入服务。 概述 物联网平台支持创建设备的“影子”。设备影子是一个JSON文件,用于存储设备的在线状态、设备最近一次上报的设备属性值、应用服务器期望下发的配置。每个设备有且只有一个设备影子,设备可以获取和设置设备影子以此来同步设备属性值
SDK介绍(联通用户专用) SDK分类 非联通用户请查看设备接入服务。 为了帮助设备快速连接到物联网平台,华为提供了Agent Lite SDK、Agent Tiny SDK和LiteOS SDK。如下图所示,支持TCP/IP协议栈的设备集成Agent Lite SDK或Agent
NB设备命令状态变化通知 典型场景 第三方应用通过物联网平台创建设备命令时,如果设置了callbackurl回调地址,当命令状态变化时(执行失败,执行成功,超时,发送,已送达),平台会向第三方应用推送通知消息。 接口功能 支持物联网平台在命令状态发生变化时向第三方应用推送通知消息。