检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
verifyCode 必选 String 设备绑定验证码。 如果通过控制台注册设备,则verifyCode填写为设备注册时设置的preSecret(预置密钥)。 如果通过开发中心注册设备,则verifyCode填写为设备注册时设置的nodeId(设备标识)。 deviceInfo 必选 IotaDeviceInfo
注册设备通知 接口说明 应用服务器在物联网平台订阅了注册设备通知后(订阅的通知类型为deviceAdded),当应用服务器通过“注册设备”接口在平台注册设备时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI 由
查询单个订阅 接口说明 应用服务器可在物联网平台上创建多个订阅,以订阅不同类型的设备变更通知。应用服务器若需要查看某个订阅的配置信息,可调用此接口进行查询。 URI 请求方法 GET URI /iocm/app/sub/v1.2.0/subscriptions/{subscriptionId}
刷新token 接口说明 应用服务器通过鉴权接口获取到的accessToken是有效时间的,在accessToken快过期时,应用服务器通过调用此接口,获取新的accessToken。 URI 请求方法 POST URI /iocm/app/sec/v1.1.0/refreshToken
设备数据变化通知 接口说明 应用服务器在物联网平台订阅了设备数据变化通知后(订阅的通知类型为deviceDataChanged),当设备上报单个服务属性数据时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI 由
设备服务能力增加通知 接口说明 应用服务器在物联网平台订阅了设备服务能力增加通知后(订阅的通知类型为deviceCapabilitiesAdded),在物联网平台上新增设备Profile文件时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI
设备服务能力删除通知 接口说明 应用服务器在物联网平台订阅了设备服务能力删除通知后(订阅的通知类型为deviceCapabilitiesDeleted),在物联网平台上删除设备Profile文件时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI
软件升级结果通知 接口说明 应用服务器在物联网平台订阅了软件升级结果通知后(订阅的通知类型为swUpgradeResultNotify),当设备的软件升级任务执行完成时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI
固件升级结果通知 接口说明 应用服务器在物联网平台订阅了固件升级结果通知后(订阅的通知类型为fwUpgradeResultNotify),当设备的固件升级任务执行完成时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI
设备服务能力变化通知 接口说明 应用服务器在物联网平台订阅了设备服务能力变化通知后(订阅的通知类型为deviceCapabilitiesChanged),在物联网平台上设备Profile文件中的服务和属性被修改时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。
设备数据批量变化通知 接口说明 应用服务器在物联网平台订阅了设备数据批量变化通知后(订阅的通知类型为deviceDatasChanged),当设备同时上报多个服务属性数据时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST
在Token过期前,获取新的Token。 设备管理 API 说明 注册设备(验证码方式) 在物联网平台注册一个设备,仅适用于使用LWM2M/CoAP协议或Agent Lite接入的设备。 注册设备(密码方式) 在物联网平台注册一个设备,仅适用于使用MQTT协议接入的设备。 刷新设备密钥
批量查询订阅 接口说明 应用服务器可在物联网平台上创建多个订阅,以订阅不同类型的设备变更通知。应用服务器若需要查看本应用下所有订阅配置,或者查看某种订阅类型下的所有订阅配置,可调用此接口进行查询。 URI 请求方法 GET URI /iocm/app/sub/v1.2.0/subscriptions
固件升级状态变更通知 接口说明 应用服务器在物联网平台订阅了固件升级状态变更通知后(订阅的通知类型为fwUpgradeStateChangeNotify),当设备进行固件升级,升级任务的状态发生变化时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。
规则事件通知 接口说明 应用服务器在物联网平台订阅了规则事件通知后(订阅的通知类型为ruleEvent),当平台中配置的规则触发时,平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
查询设备激活状态 典型场景 第三方应用通过“注册设备”接口在物联网平台注册设备后,在设备首次接入平台之前,设备的激活状态为false;当设备首次接入平台后,设备的激活状态为true(无论设备接入后是处于在线、离线或异常状态)。第三方应用可调用此接口查询设备在物联网平台的激活状态,确定设备是否已接入平台。
创建设备命令撤销任务 接口说明 应用服务器向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行(PENDING状态),此时应用服务器可调用此接口撤销指定设备的所有未下发的命令,对于已下发成功的命令不可撤销。 URI 请求方法 POST URI /iocm/app/cmd/v1
命令状态变化通知 接口说明 应用服务器通过物联网平台创建设备命令时,如果设置了callbackurl回调地址,当命令状态变化时(执行失败,执行成功,超时,发送,已送达),平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息,请务必返回响应码。 URI 请求方法 POST URI
修改设备命令 接口说明 应用服务器向设备下发命令后,如果由于命令排队、设备不在线等原因,物联网平台还未把命令下发给设备执行,此时应用服务器可调用此接口修改该命令的状态信息。仅能修改还处于PENDING状态的命令,且当前仅支持把命令状态修改为CANCELED状态,即撤销命令的执行。
firmware_upgrade software_upgrade deviceId String 操作设备的设备ID,用于唯一标识一个设备,在注册设备时由物联网平台分配获得。 status String 子任务状态。 wait:等待 processing:正在执行 fail:失败 success:成功