
# API使用指导
为了降低应用侧的开发难度、提升应用侧开发效率，物联网平台向应用侧开放了API（Application Programming Interface）。您可以调用开放的API，快速集成物联网平台的功能，如产品管理、设备管理、订阅管理、设备命令、规则管理等功能。
![](https://support.huaweicloud.com/devg-iothub/public_sys-resources/note_3.0-zh-cn.png)
应用侧需要通过IAM服务鉴权，获取token，详细步骤可参考[调测"获取IAM用户Token"接口](https://support.huaweicloud.com/devg-iothub/iot_02_4008.html#ZH-CN_TOPIC_0187472793__section794712581457)。
![](https://support.huaweicloud.com/devg-iothub/figure/zh-cn_image_0287260226.png "点击放大")
#### 应用开发资源
为了降低应用的开发难度、提升开发效率，物联网平台开放了应用侧API。应用通过调用物联网平台的API，实现安全接入、设备管理、数据采集、命令下发等业务场景。
| 资源包名                | 描述                                                                                                                                                                                                                        | 下载                                                                                                             |
|:---|:---|:---|
| 应用侧开发 API Java Demo | 物联网平台为应用服务器提供了[应用侧API](https://support.huaweicloud.com/api-iothub/iot_06_v5_0001.html)，能够让开发者快速验证API开放的能力，体验业务功能，熟悉业务流程。                                                                                                  | [API Java Demo](https://developer.obs.cn-north-4.myhuaweicloud.com/manage/north/Java/ApiDemo/javaApiDemo2.zip) |
| 应用侧 Java SDK        | 应用侧Java SDK提供Java方法调用[应用侧API](https://support.huaweicloud.com/api-iothub/iot_06_v5_0001.html)与平台通信。使用指南可以参考[应用侧Java SDK使用指南](https://github.com/huaweicloud/huaweicloud-sdk-java-v3/blob/master/README_CN.md)。            | [应用侧Java SDK](https://github.com/huaweicloud/huaweicloud-sdk-java-v3/releases)                                 |
| 应用侧 .Net SDK        | 应用侧.Net SDK提供.Net方法调用[应用侧API](https://support.huaweicloud.com/api-iothub/iot_06_v5_0001.html)与平台通信。使用指南可以参考[应用侧.Net SDK使用指南](https://github.com/huaweicloud/huaweicloud-sdk-net-v3/blob/master/README_CN.md)。             | [应用侧.Net SDK](https://github.com/huaweicloud/huaweicloud-sdk-net-v3/releases)                                  |
| 应用侧 Python SDK      | 应用侧Python SDK提供Python方法调用[应用侧API](https://support.huaweicloud.com/api-iothub/iot_06_v5_0001.html)与平台通信。使用指南可以参考[应用侧Python SDK使用指南](https://github.com/huaweicloud/huaweicloud-sdk-python-v3/blob/master/README_CN.md)。    | [应用侧Python SDK](https://github.com/huaweicloud/huaweicloud-sdk-python-v3/releases)                             |
| 应用侧 Go SDK          | 应用侧Go SDK提供Go方法调用[应用侧API](https://support.huaweicloud.com/api-iothub/iot_06_v5_0001.html)与平台通信。使用指南可以参考[应用侧Go SDK使用指南](https://github.com/huaweicloud/huaweicloud-sdk-go-v3/blob/master/README_CN.md)。                    | [应用侧Go SDK](https://github.com/huaweicloud/huaweicloud-sdk-go-v3/releases)                                     |
| 应用侧 Node.js SDK     | 应用侧Node.js SDK提供Node.js方法调用[应用侧API](https://support.huaweicloud.com/api-iothub/iot_06_v5_0001.html)与平台通信。使用指南可以参考[应用侧Node.js SDK使用指南](https://github.com/huaweicloud/huaweicloud-sdk-nodejs-v3/blob/master/README_CN.md)。 | [应用侧Node.js SDK](https://github.com/huaweicloud/huaweicloud-sdk-nodejs-v3/releases)                            |
| 应用侧 PHP SDK         | 应用侧PHP SDK提供PHP方法调用[应用侧API](https://support.huaweicloud.com/api-iothub/iot_06_v5_0001.html)与平台通信。使用指南可以参考[应用侧PHP SDK使用指南](https://github.com/huaweicloud/huaweicloud-sdk-php-v3/blob/master/README_CN.md)。                | [应用侧PHP SDK](https://github.com/huaweicloud/huaweicloud-sdk-php-v3/releases)                                   |
   
#### 接口介绍
| API分组                                                                                                                                          | 应用场景                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
|:---|:---|
| [产品管理](https://support.huaweicloud.com/api-iothub/iot_06_v5_0080.html)                                                                         | 产品模型定义了该产品下所有设备具备的能力或特征，产品管理为应用服务器提供对已导入物联网平台中产品模型的操作管理功能。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| [设备管理](https://support.huaweicloud.com/api-iothub/iot_06_v5_0048.html)                                                                         | 设备管理为应用服务器提供对设备的操作管理功能，包括对设备基本信息和设备数据的操作。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| [设备消息](https://support.huaweicloud.com/api-iothub/iot_06_v5_0058.html)                                                                         | 设备消息为应用服务器提供向设备透传消息的功能。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| [设备命令](https://support.huaweicloud.com/api-iothub/iot_06_v5_0038.html)                                                                         | 设备的产品模型中定义了物联网平台可向设备下发的命令，设备命令为应用服务器提供向设备下发命令的功能，实现对设备的控制操作。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| [设备属性](https://support.huaweicloud.com/api-iothub/iot_06_v5_0034.html)                                                                         | 设备的产品模型中定义了物联网平台可向设备下发的属性，设备属性为应用服务器提供向设备下发属性的功能。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| [AMQP队列管理](https://support.huaweicloud.com/api-iothub/iot_06_v5_0103.html)                                                                     | AMQP队列管理为客户创建、删除、查看队列。AMQP队列可通过规则订阅后通过AMQP客户端接收消息数据。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| [接入凭证管理](https://support.huaweicloud.com/api-iothub/iot_06_v5_0111.html)                                                                       | 接入凭证是用于AMQP、MQTTS等协议建立长连接时认证使用。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| [数据转发](https://support.huaweicloud.com/api-iothub/iot_06_v5_01306.html)、[设备联动](https://support.huaweicloud.com/api-iothub/iot_06_v5_0082.html) | 规则管理为应用服务器提供物联网平台的规则引擎功能，通过设置规则实现业务的联动变化或将数据转发至其他华为云服务。包含设备联动和数据转发两种类型。 - 设备联动：包含触发条件和执行动作两部分。当满足设置的触发条件后，触发相应动作，如"下发命令"、"发送通知"、"上报告警"、"恢复告警"。  - 数据转发：包含设置转发数据、设置转发目标和启动规则三部分。支持转发至"数据接入服务DIS"、"分布式消息服务 Kafka"、"对象存储服务 OBS"、"应用与数据集成平台 ROMA Connect"、"第三方应用服务（HTTP推送）"、"AMQP推送消息队列"。                                                                                           |
| [订阅管理](https://support.huaweicloud.com/api-iothub/iot_06_v5_01201.html)                                                                        | 订阅管理为应用服务器提供对物联网平台资源的订阅功能，若订阅的资源发生变化，平台会通知应用服务器。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| [设备影子](https://support.huaweicloud.com/api-iothub/iot_06_v5_0079.html)                                                                         | 设备影子是一个用于存储和检索设备当前状态信息的文件，设备影子为应用服务器提供对设备影子的操作管理功能。 - 每个设备有且只有一个设备影子，由设备ID唯一标识。  - 设备影子仅保存最近一次设备的上报数据和用户设置的预期数据。  - 无论该设备是否在线，都可以通过该影子查询和设置设备的状态。   |
| [设备组管理](https://support.huaweicloud.com/api-iothub/iot_06_v5_0053.html)                                                                        | 设备组管理为应用服务器提供对设备组的管理操作功能，包括对设备组信息和设备组设备的操作。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| [标签管理](https://support.huaweicloud.com/api-iothub/iot_06_v5_0009.html)                                                                         | 标签可用于对资源进行分类，标签管理为应用服务器提供对各类资源绑定和解绑标签功能。 当前仅设备支持标签。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| [资源空间管理](https://support.huaweicloud.com/api-iothub/iot_06_v5_6011.html)                                                                       | 资源空间管理为应用服务器提供对资源空间的管理能力，包括资源空间的增删改查。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| [批量任务](https://support.huaweicloud.com/api-iothub/iot_06_v5_0028.html)                                                                         | 批量任务为应用服务器提供批量处理功能，对接入物联网平台的设备进行批量操作。 - 目前提供批量软、固件升级，批量创建/删除/更新设备，批量冻结/解冻设备，批量创建同步/异步命令，批量创建消息和批量配置设备影子的能力。  - 当前单用户单一任务类型的未完成的任务最大为10，超过则无法创建新的任务。                                                                                                                                   |
| [CA证书](https://support.huaweicloud.com/api-iothub/iot_06_v5_0099.html)                                                                         | CA证书管理为应用服务器提供对CA证书进行操作管理功能，包括对CA证书进行上传、验证、查询等操作。物联网平台支持使用证书进行设备接入认证。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| [OTA升级包管理](https://support.huaweicloud.com/api-iothub/CreateOtaPackage.html)                                                                   | OTA升级包管理为应用服务器提供对升级包进行操作管理功能，包括对升级包的创建、查询、删除等操作。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| [广播消息](https://support.huaweicloud.com/api-iothub/BroadcastMessage.html)                                                                       | 广播消息为应用服务器向订阅了指定Topic的所有在线设备发布消息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| [设备隧道管理](https://support.huaweicloud.com/api-iothub/AddTunnel.html)                                                                            | 设备隧道可用于应用服务器与设备进行数据传输。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| [数据流转积压策略管理](https://support.huaweicloud.com/api-iothub/CreateRoutingBacklogPolicy.html)                                                       | 数据流转积压策略管理为应用服务器提供了对积压策略的管理操作功能，包括对数据流转积压策略的创建，查询，修改删除等操作功能。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| [数据流转流控策略管理](https://support.huaweicloud.com/api-iothub/CreateRoutingFlowControlPolicy.html)                                                   | 数据流转流控策略管理为应用服务器提供了对流控策略的管理操作功能，包括对数据流转流控策略的创建，查询，修改删除等操作功能。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
   
#### 相关FAQ
[应用集成相关问题](https://support.huaweicloud.com/iothub_faq/iot_faq_01004.html)
[消息通信相关问题](https://support.huaweicloud.com/iothub_faq/iot_faq_00225.html)
[订阅推送相关问题](https://support.huaweicloud.com/iothub_faq/iot_faq_00101.html)
[应用服务器如何通过IoTDA获取设备数据？](https://support.huaweicloud.com/iothub_faq/iot_faq_00011.html)
[IAM用户访问API提示没有权限？](https://support.huaweicloud.com/iothub_faq/iothub_faq_0002.html)
