检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
设备绑定 接口功能 设备第一次接入物联网平台时需要进行绑定操作，上层应用通过调用该接口传入设备序列号或者MAC地址以及设备信息来绑定到物联网平台。 在绑定前需要调用BindConfig.setConfig接口设置物联网平台的IP与端口。 设备绑定是指设备第一次接入物联网平台的过程
查询订阅列表 接口说明 应用服务器可调用此接口查询物联网平台中的订阅配置信息列表。 URI 请求方法 GET URI /v5/iot/{project_id}/subscriptions 传输协议 HTTPS 请求参数 名称 必选/可选 类型 位置 说明 X-Auth-Token
命令下发（联通用户专用） 非联通用户请查看设备接入服务。 概述 为能有效地对设备进行管理，设备的产品模型中定义了物联网平台可向设备下发的命令，应用服务器可以调用物联网平台开放的API接口向单个设备或批量设备下发命令，或者用户通过物联网平台直接向单个设备下发命令，以实现对设备的远程控制。
查询设备服务能力 典型场景 第三方应用若需要了解设备可上报哪些服务属性数据，以及设备支持下发哪些命令，可调用此接口在物联网平台查询设备的Profile文件中定义的设备服务能力信息。 接口功能 支持第三方应用在物联网平台查询设备的服务属性、设备命令等服务能力信息。 接口描述 1 Q
查询设备服务能力 典型场景 第三方应用若需要了解设备可上报哪些服务属性数据，以及设备支持下发哪些命令，可调用此接口在物联网平台查询设备的Profile文件中定义的设备服务能力信息。 接口功能 支持第三方应用在物联网平台查询设备的服务属性、设备命令等服务能力信息。 接口描述 1 def
查询设备命令撤销任务 典型场景 第三方应用创建了设备命令撤销任务后，可调用此接口查询设备命令撤销任务的详细信息和执行状态，以了解撤销任务的执行情况。 接口功能 支持第三方应用在物联网平台查询设备命令撤销任务信息和状态，可指定条件查询单个或多个撤销任务。 接口描述 1 def qu
设备登录 接口功能 设备在第一次绑定后，或者在设备重启后需要进行登录的流程。 接口描述 1 public static boolean login(); 接口所属类 LoginService 接口返回值 返回值 描述 true 成功。 false 失败。 此返回值是调用接口的同
批量删除订阅 典型场景 第三方应用若不再需要接收物联网平台推送的订阅通知消息，或者不再需要接收某类订阅通知消息，可调用此接口批量删除订阅配置，取消订阅。 接口功能 支持第三方应用在物联网平台批量删除订阅配置，可删除全部订阅，或删除指定订阅类型的所有订阅，或删除指定回调URL地址的所有订阅。
设备登出 接口功能 断开与物联网平台的连接。 接口描述 1 public static boolean logout(); 接口所属类 LoginService 接口返回值 返回值 描述 true 成功。 false 失败。 此返回值是调用接口的同步返回结果，返回true只是说
查询设备命令撤销任务 典型场景 第三方应用创建了设备命令撤销任务后，可调用此接口查询设备命令撤销任务的详细信息和执行状态，以了解撤销任务的执行情况。 接口功能 支持第三方应用在物联网平台查询设备命令撤销任务信息和状态，可指定条件查询单个或多个撤销任务。 接口描述 1 QueryD
鉴权 典型场景 第三方应用首次访问物联网平台的开放API时，需调用此接口完成接入认证；第三方应用在物联网平台的认证过期后，需调用此接口重新进行认证，才能继续访问物联网平台的开放API。 接口功能 支持第三方应用在首次访问物联网平台的开放API之前，完成在物联网平台的接入认证。 注意事项
批量删除订阅 典型场景 第三方应用若不再需要接收物联网平台推送的订阅通知消息，或者不再需要接收某类订阅通知消息，可调用此接口批量删除订阅配置，取消订阅。 接口功能 支持第三方应用在物联网平台批量删除订阅配置，可删除全部订阅，或删除指定订阅类型的所有订阅，或删除指定回调URL地址的所有订阅。
查询指定升级任务结果 典型场景 在创建了设备软件升级任务或固件升级任务后，第三方应用可调用此接口查询某个升级任务详细信息，以查看升级任务的配置信息和执行情况等。 接口功能 支持第三方应用在物联网平台查询单个固件或软件升级任务的详细信息，包括升级任务的配置信息和执行情况等。 接口描述
设备状态变化结果通知 接口说明 应用服务器在物联网平台订阅设备状态变化通知事件后（资源为device.status，事件为update），当物联网平台中的设备状态发生变化时，平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时，请务必返回响应码。 URI 请求方法
消息结构体说明 转发设备上报的属性 根据定义的产品模型，上报设备属性至平台。结构体描述如下： 表1 属性上报规则转发结构体 参数名称 类型 描述 device_id String 设备ID，用于唯一标识一个设备，在注册设备时由物联网平台分配获得。 services services[]
查询指定升级任务结果 典型场景 在创建了设备软件升级任务或固件升级任务后，第三方应用可调用此接口查询某个升级任务详细信息，以查看升级任务的配置信息和执行情况等。 接口功能 支持第三方应用在物联网平台查询单个固件或软件升级任务的详细信息，包括升级任务的配置信息和执行情况等。 接口描述
鉴权 典型场景 第三方应用首次访问物联网平台的开放API时，需调用此接口完成接入认证；第三方应用在物联网平台的认证过期后，需调用此接口重新进行认证，才能继续访问物联网平台的开放API。 接口功能 支持第三方应用在首次访问物联网平台的开放API之前，完成在物联网平台的接入认证。 注意事项
刷新设备密钥 典型场景 已在物联网平台注册的设备，若设备的唯一标识码发生变更（如更换设备等场景），第三方应用需要调用此接口在物联网平台更新设备的唯一标识，并重新绑定设备。 仅当设备处于离线状态时，才能进行刷新设备密钥操作。 接口功能 支持第三方应用在物联网平台更新已注册设备的no
返回结果 请求发送以后，您会收到响应，包含：状态码、响应消息头和响应消息体。 状态码 状态码是一组从1xx到5xx的数字代码，状态码表示了请求响应的状态，物联网平台返回的状态码如下所示。 对于鉴权接口，如果调用后返回状态码为“200”，则表示请求成功。 状态码 编码 状态码说明 200
设备消息状态变更通知 接口说明 应用服务器在物联网平台订阅了消息状态变更通知后（订阅的资源为device.message.status，事件为update），当消息状态变更时，平台会向应用服务器推送通知消息。 注意事项 应用服务器收到推送消息时，请务必返回响应码。 URI 请求方法
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
