检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
软件升级状态变更通知 典型场景 第三方应用在物联网平台订阅了软件升级状态变更通知后（订阅的通知类型为swUpgradeStateChangeNotify），当设备进行软件升级，升级任务的状态发生变化时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了软件升级状态变更通知的第三方应用推送通知消息。
返回结果 请求发送以后，您会收到响应，包含：状态码、响应消息头和响应消息体。 状态码 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，物联网平台返回的状态码如下所示。 对于鉴权接口，如果调用后返回状态码为“200”，则表示请求成功。 状态码 编码 状态码说明 200
使用前必读 非联通用户请查看设备接入服务。 概述 物联网平台提供了Agent Lite SDK，帮助设备快速连接到物联网平台。支持TCP/IP协议栈的设备在集成Agent Lite SDK后，可以直接与物联网平台通信。不支持TCP/IP协议栈的设备例如蓝牙设备、ZigBee设备等，可以通过集成了Agent
固件升级状态变更通知 典型场景 第三方应用在物联网平台订阅了固件升级状态变更通知后（订阅的通知类型为fwUpgradeStateChangeNotify），当设备进行固件升级，升级任务的状态发生变化时，平台会向第三方应用推送通知消息。 接口功能 支持物联网平台向订阅了固件升级状态变更通知的第三方应用推送通知消息。
查询订阅 接口说明 应用服务器可调用此接口查询物联网平台中指定订阅的配置信息。 URI 请求方法 GET URI /v5/iot/{project_id}/subscriptions/{subscription_id} 传输协议 HTTPS 请求参数 名称 必选/可选 类型 位置
查询指定设备组成员 接口说明 应用服务器若需要查看某个设备组中的设备成员分布情况，可调用此接口查询指定设备组的设备成员列表信息。 URI 请求方法 GET URI /iocm/app/dm/v1.2.0/devices/ids 传输协议 HTTPS 请求参数 参数 必选/可选 类型
注册设备通知 接口说明 应用服务器在物联网平台订阅了注册设备通知后（订阅的通知类型为deviceAdded），当应用服务器通过“注册设备”接口在平台注册设备时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由
查询指定批量任务信息 接口说明 应用服务器通过“创建批量任务”接口创建了设备的批量操作任务后，可调用此接口查询该批量任务的信息，包括任务的当前状态、子任务（指批量任务中一个设备执行的任务）完成情况等。 URI 请求方法 GET URI /iocm/app/batchtask/v1
修改订阅 接口说明 应用服务器可调用此接口修改物联网平台中的指定订阅配置，当前仅支持修改订阅回调地址（callbackurl）。 URI 请求方法 PUT URI /v5/iot/{project_id}/subscriptions/{subscription_id} 传输协议 HTTPS
设备命令响应通知 接口说明 应用服务器在物联网平台订阅了设备命令响应通知后（订阅的通知类型为commandRsp），当平台向设备下发命令，并收到设备返回的命令响应消息（如命令执行成功或者执行失败，设备要向平台返回指定内容响应）时，平台会向应用服务器推送通知消息。 仅适用于使用MQ
设备登录 接口功能 设备在第一次绑定后，或者在设备重启后需要进行登录的流程。 接口描述 1 HW_INT IOTA_Login(); 接口返回值 参见函数标准返回值 此返回值是调用接口的同步返回结果，返回0只是说明接口调用成功，并不说明登录成功，登录成功需要收到IOTA_TOP
绑定设备通知 接口说明 应用服务器在物联网平台订阅了绑定设备通知后（订阅的通知类型为bindDevice），当设备接入并绑定物联网平台时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的callbackurl决定。
设备信息变化通知 接口说明 应用服务器在物联网平台订阅了设备信息变化通知后（订阅的通知类型为deviceInfoChanged），当设备的配置或状态信息（如设备厂商信息、位置信息、版本信息、在线状态信息等）发生变化时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。
订阅平台管理数据 接口说明 应用服务器可调用此接口向物联网平台订阅设备相关的管理数据，当设备进行版本升级等相关操作时，平台会向应用服务器发送通知消息，知会其具体的操作状态或操作结果信息。 URI 请求方法 POST URI /iodm/app/sub/v1.1.0/subscribe
删除设备组 接口说明 若因分组变更，应用服务器不再需要使用某个设备组，且不想在物联网平台上继续保存该设备组信息时，可调用此接口在物联网平台删除指定设备组。 URI 请求方法 DELETE URI /iocm/app/devgroup/v1.3.0/devGroups/{devGroupId}
添加设备 接口功能 当有新设备接入网关后，通过调用设备添加接口将非直连设备接入物联网平台，并且获得平台分配的唯一设备逻辑ID。 接口描述 1 HW_INT IOTA_HubDeviceAdd(HW_UINT uiCookie, const ST_IOTA_DEVICE_INFO *pstDeviceInfo);
设备响应命令 接口说明 设备对物联网平台控制命令的应答。 应用服务器要需要调用“订阅平台业务数据”API订阅“commandRsp”类型的通知后，才能接收到设备对控制命令的应答。 Topic Topic /huawei/v1/devices/{deviceId}/data/{codecMode}
查询指定设备组 接口说明 应用服务器若需要查看某个设备组的信息，以了解该设备组的使用情况，可调用此接口查询指定设备组的信息。 URI 请求方法 GET URI /iocm/app/devgroup/v1.3.0/devGroups/{devGroupId} 传输协议 HTTPS 请求参数
应用快速接入（联通用户专用） 非联通用户请查看设备接入服务。 为了降低应用侧的开发难度、提升应用侧开发效率，物联网平台向应用侧开放了丰富的Restful API。本文档以Postman为例，模拟应用服务器以HTTPS协议为例接入物联网平台。 前提条件 已经注册华为云官方帐号，可点击注册页面完成注册。
删除设备 接口说明 已在物联网平台注册的设备，若不再需要接入平台时，应用服务器可调用此接口在物联网平台删除设备，使设备无法再接入平台。后续设备若需要再次接入平台，则需重新注册设备。 URI 请求方法 DELETE URI /iocm/app/dm/v1.4.0/devices/{deviceId}
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
