检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备服务调用 典型场景 设备Profile文件中定义了物联网平台可向设备下发的命令，第三方应用可调用此接口向设备下发命令，配置或修改设备的服务属性，以实现对设备的控制。 物联网平台不对设备命令进行缓存而是直接下发命令，设备不在线时命令下发失败。下发命令的具体格式需要第三方应用与设备自定义
查询设备影子 典型场景 若设备处于离线或异常状态时，第三方应用无法通过命令下发的方式向设备下发配置。此时可把要下发的配置设置到设备影子，当设备重新上线时，设备影子会把配置下发给设备。第三方应用可调用此接口查看设备影子上的设备配置信息及最新的设备上报数据信息。 接口功能 支持第三方应用查询单个设备的设备影子信息
注册设备（验证码方式） 典型场景 在设备接入物联网平台前，第三方应用需要调用此接口在物联网平台注册设备，并把设备的唯一标识码（如IMEI）设置为设备接入平台的验证码。在设备接入物联网平台时携带设备唯一标识，完成设备的接入认证。 接口功能 支持第三方应用在物联网平台注册设备，完成注册后设备方可接入物联网平台
设备命令响应通知 接口说明 应用服务器在物联网平台订阅了设备命令响应通知后（订阅的通知类型为commandRsp），当平台向设备下发命令，并收到设备返回的命令响应消息（如命令执行成功或者执行失败，设备要向平台返回指定内容响应）时，平台会向应用服务器推送通知消息。 仅适用于使用MQTT
设备登录 接口功能 设备在第一次绑定后，或者在设备重启后需要进行登录的流程。 接口描述 1 HW_INT IOTA_Login(); 接口返回值 参见函数标准返回值 此返回值是调用接口的同步返回结果，返回0只是说明接口调用成功，并不说明登录成功，登录成功需要收到IOTA_TOPIC_CONNECTED_NTY
查询指定批量任务信息 接口说明 应用服务器通过“创建批量任务”接口创建了设备的批量操作任务后，可调用此接口查询该批量任务的信息，包括任务的当前状态、子任务（指批量任务中一个设备执行的任务）完成情况等。 URI 请求方法 GET URI /iocm/app/batchtask/v1.1.0
刷新设备密钥 典型场景 已在物联网平台注册的设备，若设备的唯一标识码发生变更（如更换设备等场景），第三方应用需要调用此接口在物联网平台更新设备的唯一标识，并重新绑定设备。 仅当设备处于离线状态时，才能进行刷新设备密钥操作。 接口功能 支持第三方应用在物联网平台更新已注册设备的nodeId
订阅平台管理数据 接口说明 应用服务器可调用此接口向物联网平台订阅设备相关的管理数据，当设备进行版本升级等相关操作时，平台会向应用服务器发送通知消息，知会其具体的操作状态或操作结果信息。 URI 请求方法 POST URI /iodm/app/sub/v1.1.0/subscribe
查询设备命令撤销任务 接口说明 应用服务器创建了设备命令撤销任务后，可调用此接口查询设备命令撤销任务的详细信息和执行状态，以了解撤销任务的执行情况，可指定条件查询单个或多个撤销任务。 URI 请求方法 GET URI /iocm/app/cmd/v1.4.0/deviceCommandCancelTasks
绑定设备通知 接口说明 应用服务器在物联网平台订阅了绑定设备通知后（订阅的通知类型为bindDevice），当设备接入并绑定物联网平台时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码。 URI 请求方法 POST URI 由应用服务器订阅请求消息中的
设备信息变化通知 接口说明 应用服务器在物联网平台订阅了设备信息变化通知后（订阅的通知类型为deviceInfoChanged），当设备的配置或状态信息（如设备厂商信息、位置信息、版本信息、在线状态信息等）发生变化时，平台会向应用服务器推送通知消息。 注意事项 应用收到推送消息，请务必返回响应码
查询设备历史数据 接口说明 在日常运行中，物联网平台会收到并保存设备上报业务数据，应用服务器若需要查看某个设备上报到平台的历史数据，可调用此接口查询获取。 URI 请求方法 GET URI /iocm/app/data/v1.2.0/deviceDataHistory 传输协议 HTTPS
设备快速接入（联通用户专用） 非联通用户请查看设备接入服务。 本文档以MQTT.fx为例，介绍以MQTT原生协议接入物联网平台。MQTT.fx是目前主流的MQTT客户端，可以快速验证是否可以与物联网平台服务交互发布或订阅消息。 前提条件 已经注册华为云官方帐号，可点击注册页面完成注册
查询设备命令 接口说明 应用服务器向设备下发命令后，可调用此接口在物联网平台查询下发命令的状态及内容信息，以了解命令的执行情况，可查询指定时间段内本应用下的所有下发命令，或者指定设备的所有下发命令。 URI 请求方法 GET URI /iocm/app/cmd/v1.4.0/deviceCommands
设备响应命令 接口说明 设备对物联网平台控制命令的应答。 应用服务器要需要调用“订阅平台业务数据”API订阅“commandRsp”类型的通知后，才能接收到设备对控制命令的应答。 Topic Topic /huawei/v1/devices/{deviceId}/data/{codecMode
修改设备组 接口说明 若因业务变更需要修改设备组的信息，如设备组名称、设备组的设备数量限制等，应用服务器可调用此接口修改指定设备组的信息。 URI 请求方法 PUT URI /iocm/app/devgroup/v1.3.0/devGroups/{devGroupId} 传输协议
查询指定设备组 接口说明 应用服务器若需要查看某个设备组的信息，以了解该设备组的使用情况，可调用此接口查询指定设备组的信息。 URI 请求方法 GET URI /iocm/app/devgroup/v1.3.0/devGroups/{devGroupId} 传输协议 HTTPS 请求参数
修改设备信息 接口说明 应用服务器在物联网平台注册设备后，若设备的基本信息发生变更，可调用此接口在物联网平台修改设备的基本信息，包括设备类型、设备模型、厂商信息、接入协议等。 URI 请求方法 PUT URI /iocm/app/dm/v1.4.0/devices/{deviceId
删除设备组 接口说明 若因分组变更，应用服务器不再需要使用某个设备组，且不想在物联网平台上继续保存该设备组信息时，可调用此接口在物联网平台删除指定设备组。 URI 请求方法 DELETE URI /iocm/app/devgroup/v1.3.0/devGroups/{devGroupId
应用快速接入（联通用户专用） 非联通用户请查看设备接入服务。 为了降低应用侧的开发难度、提升应用侧开发效率，物联网平台向应用侧开放了丰富的Restful API。本文档以Postman为例，模拟应用服务器以HTTPS协议为例接入物联网平台。 前提条件 已经注册华为云官方帐号，可点击注册页面完成注册
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
