检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
典型场景 若因业务变更需要修改设备组的信息，如设备组名称、设备组的设备数量限制等，第三方应用可调用此接口修改指定设备组的信息。 接口功能 支持第三方应用在物联网平台修改指定设备组的信息。 接口描述 1 ModifyDeviceGroupOutDTO modifyDeviceGroup(
设备接收解绑定命令 接口功能 注册设备解绑定接收广播来接收处理平台下发的直连设备解绑定命令，开发者收到该广播后需要删除直连设备的配置信息并且释放所有资源，下一次重启后需要重新进行绑定。 接口描述 1 IOTA_TOPIC_CMD_UNBIND_RECEIVE; 示例 1 2 3
Json组件使用说明 该组件为Agent Lite提供给开发者的工具组件，如果开发者无法进行Json格式的编码和解码，则可以使用该组件进行编码和解码。主要用于上报数据组装与下发命令解析。 1. Json编码 使用Json组件进行编码的流程。 创建Json编码对象。 1 HW_JSONOBJ
典型场景 第三方应用通过“创建批量任务”接口创建了设备的批量操作任务后，可调用此接口查询该批量任务中子任务的详情信息，如任务的执行状态、任务内容等。 接口功能 支持第三方应用根据条件查询批量任务中子任务的详情信息，支持查询本应用创建的批量任务信息。 接口描述 1 QueryTaskDetailsOutDTO
停止定时刷新token 典型场景 第三方应用通过调用此接口，停止定期刷新accessToken，一旦调用了stopRefreshTokenTimer方法，调用其他业务接口，accessToken不可为null。 接口功能 停止自动获取新的accessToken，并关闭stopRe
具体的操作状态或操作结果信息。第三方应用可以调用此接口向物联网平台订阅不同类型的设备升级操作通知。 接口功能 支持第三方应用向物联网平台订阅设备的升级操作信息，当设备进行版本升级等相关操作时，平台会向第三方应用发送通知消息。 接口描述 1 def subDeviceManagementData(self
典型场景 第三方应用通过“修改设备影子”接口修改设备影子的配置时，物联网平台会保存修改记录。当第三方应用需要查看设备影子的历史配置记录时，可调用此接口查询获取。 接口功能 支持第三方应用根据设备ID，在物联网平台查询指定设备影子的历史配置数据。 接口描述 1 QueryDeviceDesiredHistoryOutDTO
设备登出 接口功能 断开与物联网平台的连接。 接口描述 1 public static boolean logout(); 接口所属类 LoginService 接口返回值 返回值 描述 true 成功。 false 失败。 示例 1 LoginService.logout();
应用调用接口过于频繁，超过流控值（默认值是100次/60s）。 处理建议：联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 403 1010005 pp_key or access_token is invalid. 错误的token信息。 处理建议：请检查接口请求中所携带的accessToken是否有误。
应用通过PushMessageReceiver类并重写回调接口接收推送消息的内容。 如果回调地址不是应用服务器本身的地址，则第三方应用需要自己实现原始回调接口。 接口描述 回调地址 https://server:port/v1.0.0/messageReceiver/cmd 回调接口 def handleNBC
输入参数无效。 处理建议：请检查接口调用请求中携带参数的合法性。 403 1010009 app throttle exceed. 应用调用接口过于频繁，超过流控值（默认值是100次/60s）。 处理建议：联系物联网平台维护人员调大流控阈值或者控制接口的调用频率。 403 1010005
绑定配置 接口功能 在设备绑定前配置平台的地址和端口。 接口描述 1 public static boolean setConfig(int key, String value); 接口所属类 BindConfig 参数说明 字段 必选/可选 类型 描述 key 必选 int 设备绑定的配置项。
绑定配置 接口功能 配置Agent Lite相关参数。 接口描述 1 2 HW_INT IOTA_ConfigSetStr(HW_INT iItem, HW_CHAR *pValue) HW_INT IOTA_ConfigSetUint(HW_INT iItem, HW_UINT
删除设备组成员 典型场景 若设备组中的一个或多个设备不再归属于该设备组，第三方应用可调用此接口从设备组删除设备成员。 接口功能 支持第三方应用在物联网平台从指定设备组删除设备。 接口描述 1 def deleteDevicesFromGroup(self, dgwdlDTO, accessAppId
查询指定设备组成员 典型场景 第三方应用若需要查看某个设备组中的设备成员分布情况，可调用此接口查询指定设备组的设备成员列表信息。 接口功能 支持第三方应用在物联网平台根据设备组ID查询指定设备组内设备列表信息。 接口描述 1 def queryDeviceGroupMembers(self, qdgmInDTO
查询指定设备组 典型场景 第三方应用若需要查看某个设备组的信息，以了解该设备组的使用情况，可调用此接口查询指定设备组的信息。 接口功能 支持第三方应用在物联网平台根据设备组ID查询指定设备组的信息。 接口描述 1 QuerySingleDeviceGroupOutDTO querySingleDeviceGroup(String
景），第三方应用需要调用此接口在物联网平台更新设备的唯一标识，并重新绑定设备。 仅当设备处于离线状态时，才能进行刷新设备密钥操作。 接口功能 支持第三方应用在物联网平台更新已注册设备的nodeId，在设备deviceId不变的情况下，重新绑新设备。 接口描述 1 def refreshDeviceKey(self
把配置下发给设备。第三方应用可调用此接口查看设备影子上的设备配置信息及最新的设备上报数据信息。 接口功能 支持第三方应用查询单个设备的设备影子信息，包括对设备的配置信息（desired区）和设备最新上报的数据信息（reported区）。 接口描述 1 def queryDeviceShadow(self
组中，第三方应用可调用此接口向指定设备组添加设备成员。在向设备组添加设备前，建议通过“查询指定设备组”接口查询该设备组的当前设备数量及最大设备数量限制，确保设备组中还有足够的可添加成员数量。 接口功能 支持第三方应用在物联网平台向指定设备组添加设备。 接口描述 1 def addDevicesToGroup(self
创建项目时，物联网平台会分配一个应用ID（接口调用时参数名为appId）作为项目的唯一标识。若应用服务器需要调用物联网平台的API接口进行一些业务处理，请求中必须携带appId以接入对应的项目空间，鉴权接口携带在Body中，其他接口的appId的值一般携带在Header中。 创
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
