设备数据变化通知 接口说明 应用服务器在物联网平台订阅了设备属性变化通知后(订阅的资源为device.data,事件为update),当设备上属性数据时,平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时,请务必返回响应码。 URI 请求方法 POST URI
设备激活通知 接口说明 应用服务器在物联网平台订阅了设备激活通知后(订阅的资源为device,事件为activate),当设备首次接入物联网平台并激活时,平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时,请务必返回响应码。 URI 请求方法 POST URI
添加设备 接口功能 当有新设备接入网关后,通过调用设备添加接口将非直连设备接入物联网平台,并且获得平台分配的唯一设备逻辑ID。 接口描述 1 public static boolean addDevice(int cookie, IotaDeviceInfo deviceInfo);
添加设备 接口功能 当有新设备接入网关后,通过调用设备添加接口将非直连设备接入物联网平台,并且获得平台分配的唯一设备逻辑ID。 接口描述 1 public static boolean addDevice(int cookie, IotaDeviceInfo deviceInfo);
创建设备命令 典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令,第三方应用可调用此接口向设备下发命令,配置或修改设备的服务属性,以实现对设备的控制。 物联网平台有两种命令下发机制: 立即下发:平台收到命令后立即下发给设备,保证实时性,不保证串行性。 缓存下发:
创建设备命令 典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令,第三方应用可调用此接口向设备下发命令,配置或修改设备的服务属性,以实现对设备的控制。 物联网平台有两种命令下发机制: 立即下发:平台收到命令后立即下发给设备,保证实时性,不保证串行性。 缓存下发:
创建设备命令 接口说明 设备Profile文件中定义了物联网平台可向设备下发的命令,应用服务器可调用此接口向设备下发命令,配置或修改设备的服务属性,以实现对设备的控制。 物联网平台有两种命令下发机制: 立即下发:平台收到命令后立即下发给设备,保证实时性,不保证串行性。 缓存下发:
消息结构体说明 转发设备上报的属性 根据定义的产品模型,上报设备属性至平台。结构体描述如下: 表1 属性上报规则转发结构体 参数名称 类型 描述 device_id String 设备ID,用于唯一标识一个设备,在注册设备时由物联网平台分配获得。 services services[]
绑定设备通知 典型场景 第三方应用在物联网平台订阅了绑定设备通知后(订阅的通知类型为bindDevice),当直连设备接入并绑定物联网平台时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了绑定设备通知的第三方应用推送通知消息。 注意事项 1. 应用在订阅平台业
注册设备通知 典型场景 第三方应用在物联网平台订阅了注册设备通知后(订阅的通知类型为deviceAdded),当第三方应用通过“注册直连设备”接口在平台注册设备时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了注册设备通知的第三方应用推送通知消息。 注意事项 1
设备信息变化通知 典型场景 第三方应用在物联网平台订阅了设备信息变化通知后(订阅的通知类型为deviceInfoChanged),当设备的配置或状态信息(如设备厂商信息、位置信息、版本信息、在线状态信息等)发生变化时,平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订
远程诊断(联通用户专用) 非联通用户请查看设备接入服务。 概述 物联网平台支持用户对接入的设备进行远程维护操作,快速定位问题及恢复业务,减少近端维护引入的高成本。当前仅支持通过控制台对NB-IoT设备进行日志收集、重启模组。 物联网平台支持基于LWM2M协议的日志收集和重启模组能力,如下表所示。
设备绑定 接口功能 设备第一次接入物联网平台时需要进行绑定操作,上层应用通过调用该接口传入设备序列号或者MAC地址以及设备信息来绑定到物联网平台。 在绑定前需要调用绑定配置接口设置物联网平台的IP与端口。 设备绑定是指设备第一次接入物联网平台的过程,需要开发者先在物联网平台注册直
创建设备命令撤销任务 典型场景 第三方应用向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行(DEFAULT状态),此时第三方应用可调用此接口撤销指定设备的所有未下发的命令,对于已下发成功的命令不可撤销。 接口功能 支持第三方应用创建设备命令
修改设备命令 典型场景 第三方应用向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行,此时第三方应用可调用此接口修改该命令的状态信息。当前仅支持把命令状态修改为CANCELED状态,即撤销命令的执行。 接口功能 支持第三方应用修改指定命令的状
修改设备命令 典型场景 第三方应用向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行,此时第三方应用可调用此接口修改该命令的状态信息。当前仅支持把命令状态修改为CANCELED状态,即撤销命令的执行。 接口功能 支持第三方应用修改指定命令的状
创建设备命令撤销任务 典型场景 第三方应用向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行(DEFAULT状态),此时第三方应用可调用此接口撤销指定设备的所有未下发的命令,对于已下发成功的命令不可撤销。 接口功能 支持第三方应用创建设备命令
API列表 应用安全接入 API 说明 鉴权 应用服务器进行认证鉴权,获取接入Token。 刷新token 在Token过期前,获取新的Token。 设备管理 API 说明 注册设备(验证码方式) 在物联网平台注册一个设备,仅适用于使用LWM2M/CoAP协议或Agent Lite接入的设备。
查询设备命令 典型场景 第三方应用向设备下发命令后,可调用此接口在物联网平台查询下发命令的状态及内容信息,以了解命令的执行情况。 接口功能 支持第三方应用在物联网平台查询下发命令的状态和内容信息,可查询指定时间段内本应用下的所有下发命令,或者指定设备的所有下发命令。 接口描述 1
网关与子设备(联通用户专用) 非联通用户请查看设备接入服务。 概述 物联网平台支持设备直连,也支持设备挂载在网关上,作为网关的子设备,由网关直连。 针对未实现TCP/IP协议栈的设备,由于无法直接同物联网平台通信,它需要通过网关进行数据转发,如下图所示。 接入流程 Agent Lite
您即将访问非华为云网站,请注意账号财产安全