检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
订阅平台管理数据 典型场景 第三方应用可向物联网平台订阅设备相关的管理数据，当物联网平台中设备进行版本升级等相关操作时，平台会向第三方应用发送通知消息，知会其具体的操作状态或操作结果信息。第三方应用可以调用此接口向物联网平台订阅不同类型的设备升级操作通知。 接口功能 支持第三方应用向物联网平台订阅设备的升级操作信息
修改设备信息 典型场景 第三方应用在物联网平台注册设备后，若设备的基本信息发生变更，也可调用此接口在物联网平台修改设备的信息。 接口功能 支持第三方应用修改设备的基本信息，包括设备类型、设备模型、厂商信息、接入协议等。 接口描述 1 def modifyDeviceInfo(self
设备影子（联通用户专用） 非联通用户请查看设备接入服务。 概述 物联网平台支持创建设备的“影子”。设备影子是一个JSON文件，用于存储设备的在线状态、设备最近一次上报的设备属性值、应用服务器期望下发的配置。每个设备有且只有一个设备影子，设备可以获取和设置设备影子以此来同步设备属性值
刷新token 典型场景 第三方应用通过鉴权接口获取到的accessToken是有有效时间的，在accessToken快过期时，第三方应用通过调用此接口，获取新的accessToken。 接口功能 支持第三方应用在accessToken到期前，从物联网平台获取新的accessToken
刷新token 典型场景 第三方应用通过鉴权接口获取到的accessToken是有有效时间的，在accessToken快过期时，第三方应用通过调用此接口，获取新的accessToken。 接口功能 支持第三方应用在accessToken到期前，从物联网平台获取新的accessToken
创建设备命令 典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令，第三方应用可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。 物联网平台有两种命令下发机制： 立即下发：平台收到命令后立即下发给设备，保证实时性，不保证串行性。 缓存下发：平台收到命令后缓存起来
查询设备激活状态 典型场景 第三方应用通过“注册设备”接口在物联网平台注册设备后，在设备首次接入平台之前，设备的激活状态为false；当设备首次接入平台后，设备的激活状态为true（无论设备接入后是处于在线、离线或异常状态）。第三方应用可调用此接口查询设备在物联网平台的激活状态，确定设备是否已接入平台
查询设备激活状态 接口说明 应用服务器通过“注册设备”接口在物联网平台注册设备后，在设备首次接入平台之前，设备的激活状态为false；当设备首次接入平台后，设备的激活状态为true（无论设备接入后是处于在线、离线或异常状态）。应用服务器可调用此接口查询设备在物联网平台的激活状态，确定设备是否已接入平台
Json组件使用说明 该组件为Agent Lite提供给开发者的工具组件，如果开发者无法进行Json格式的编码和解码，则可以使用该组件进行编码和解码。主要用于上报数据组装与下发命令解析。 1. Json编码 使用Json组件进行编码的流程。 创建Json编码对象。 1 HW_JSONOBJ
在线开发插件（联通用户专用） 非联通用户请查看设备接入服务。 借助开发中心，我们可以通过可视化的方式快速开发一款产品的编解码插件。在自定义新建产品时，如果选择使用系统模板，部分模板会包含编解码插件，您可以直接使用或在此基础上进行修改；如果选择自定义产品模板，则需要完成编解码插件的开发
删除设备组成员 典型场景 若设备组中的一个或多个设备不再归属于该设备组，第三方应用可调用此接口从设备组删除设备成员。 接口功能 支持第三方应用在物联网平台从指定设备组删除设备。 接口描述 1 def deleteDevicesFromGroup(self, dgwdlDTO, accessAppId
删除子设备 若子设备不再需要接入物联网平台，应用服务器可调用此接口解绑网关下的子设备。 此功能通过设备命令下发接口向网关下发命令实现，具体删除子设备命令需网关提前实现（即网关收到什么命令会触发删除子设备的流程），并已在设备的Profile文件中定义。当网关收到平台下发的删除子设备命令时
温度过高时自动关闭设备（联通用户专用） 非联通用户请查看设备接入服务。 场景说明 物联网平台支持设备数据上报和设备命令下发，但若要将两者联动起来，一般需要由应用服务器实现对应逻辑。 设备管理服务提供规则引擎功能，平台上简单几步操作即可实现数据上报特定数据时平台自动下发指定命令，减少应用服务器开发工作量
增加设备组成员 典型场景 若需要把新增的设备或已有设备增加到某个设备组中，第三方应用可调用此接口向指定设备组添加设备成员。在向设备组添加设备前，建议通过“查询指定设备组”接口查询该设备组的当前设备数量及最大设备数量限制，确保设备组中还有足够的可添加成员数量。 接口功能 支持第三方应用在物联网平台向指定设备组添加设备
批量删除订阅 典型场景 第三方应用若不再需要接收物联网平台推送的订阅通知消息，或者不再需要接收某类订阅通知消息，可调用此接口批量删除订阅配置，取消订阅。 接口功能 支持第三方应用在物联网平台批量删除订阅配置，可删除全部订阅，或删除指定订阅类型的所有订阅，或删除指定回调URL地址的所有订阅
离线开发的插件包通过了工具检测，上传到平台时，提示找不到插件？ 使用反编译工具打开preload文件夹下jar包，检查OSGI-INF->CodecProvideHandler.xml是否为xml格式，且不存在乱码。 图1 CodecProvideHandler.xml样例 检查name
在开发中心上传Profile，无法点击上传按钮？ 检查Profile文件的名称是否符合“deviceType_manufacturerId_model.zip”格式，并检查“deviceType”、“manufacturerId”、“model”三个字段是否和“devicetype-capability.json
修订记录 发布日期 修订记录 2019-05-28 第三次正式发布 新增 设备侧MQTT接口参考 2019-05-13 第二次正式发布 修改 查询设备历史数据，删除serviceId和property可选参数。 2018-12-20 第一次正式发布 新增 应用侧API参考
创建批量任务 典型场景 第三方应用若需要对多个设备进行批量操作时，可调用此接口创建设备的批量操作任务，当前仅支持给批量设备下发缓存命令。 接口功能 支持第三方应用在物联网平台创建设备的批量操作任务。 接口描述 1 def createBatchTask(self, btcInDTO
定时刷新token 典型场景 第三方应用通过调用此接口，定期刷新accessToken，刷新周期为鉴权方法返回值中的expiresIn，以保证accessToken不过期。accessToken由SDK管理，调用其他业务接口，accessToken可以直接传入null。 接口功能
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
