# 应用侧Node.js SDK使用指南
物联网平台提供Node.js语言的应用侧SDK供开发者使用。本文介绍应用侧 Node.js SDK的安装和配置，及使用Node.js SDK调用[应用侧API](https://support.huaweicloud.com/api-iothub/iot_06_v5_0001.html)的示例。
#### SDK获取和安装
1. 安装Node.js开发环境。 
   访问[Node.js官网](http://nodejs.cn/download/)，下载并按说明安装Node.js开发环境。
   ![](https://support.huaweicloud.com/sdkreference-iothub/public_sys-resources/note_3.0-zh-cn.png)
   华为云 Node.js SDK 支持 **Node 10.16.1** 及以上版本。
   
   
2. 安装依赖 
   ```
   npm install @huaweicloud/huaweicloud-sdk-core
   npm install @huaweicloud/huaweicloud-sdk-iotda
   ```
   
   
 
#### 代码示例
以调用[查询设备列表](https://support.huaweicloud.com/api-iothub/iot_06_v5_0048.html)接口为例，以下代码示例向您展示使用Node.js SDK的主要步骤：
1. 创建认证。
2. 创建IoTDAClient实例并初始化。
3. 实例化请求对象。
4. 调用查询设备列表接口。 
   ```
   const core = require('@huaweicloud/huaweicloud-sdk-core');
   const iotda = require("@huaweicloud/huaweicloud-sdk-iotda");
   // 认证用的ak和sk直接写到代码中有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；
   // 本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。
   const ak = process.env.HUAWEICLOUD_SDK_AK;
   const sk = process.env.HUAWEICLOUD_SDK_SK;
   // endpoint：请在控制台的"总览"界面的"平台接入地址"中查看“应用侧”的https接入地址。
   // const endpoint = "https://iotda.cn-north-4.myhuaweicloud.com";
   const endpoint = "<YOUR ENDPOINT>";
   const project_id = "<YOUR PROJECT_ID>";
   // region_id: 如果是上海一，请填写"cn-east-3"；如果是北京四，请填写"cn-north-4";如果是华南广州，请填写"cn-south-1"
   const region_id = "<YOUR REGION_ID>";
   // 配置跳过服务端证书验证（可选）
   process.env.NODE_TLS_REJECT_UNAUTHORIZED = "0"
   // 创建认证
   const credentials = new core.BasicCredentials()
                        .withAk(ak)
                        .withSk(sk)
                        // 标准版/企业版需要使用衍生算法，基础版请删除配置"withDerivedPredicate"
                        .withDerivedPredicate(core.BasicCredentials.getDefaultDerivedPredicate)
                        .withProjectId(project_id)
   // 创建IoTDAClient实例并初始化
   const client = iotda.IoTDAClient.newBuilder()
                               .withCredential(credentials)
                               .withEndpoint(endpoint)
                               .withRegion(new core.Region(region_id, endpoint))
                               .build();
   // 实例化请求对象
   const request = new iotda.ListDevicesRequest();
   // 调用查询设备列表接口
   const result = client.listDevices(request);
   result.then(result => {
       console.log("JSON.stringify(result)::" + JSON.stringify(result));
   }).catch(ex => {
       console.log("exception:" + JSON.stringify(ex));
   });
   ```
   
   | 参数         | 说明                                                                                                                                                                                                      |
   |:---|:---|
   | ak         | 您的华为云账号访问密钥ID（Access Key ID）。请在华为云控制台"我的凭证 \> 访问密钥"页面上创建和查看您的 AK/SK。更多信息请查看[访问密钥](https://support.huaweicloud.com/usermanual-ca/ca_01_0003.html)。                                                       |
   | sk         | 您的华为云账号秘密访问密钥（Secret Access Key）。                                                                                                                                                                       |
   | endpoint   | 请替换为您要访问的华为云服务所在区域的终端节点。 您可以在控制台上查看当前服务所在区域名称，区域名称、区域和终端节点的对应关系，具体步骤请参考[地区和终端节点](https://support.huaweicloud.com/devg-iothub/iot_02_1004.html#section0)。 |
   | project_id | 您要访问的华为云服务所在项目 ID ，根据您想操作的项目所属区域选择对应的项目 ID                                                                                                                                                              |
   | region_id  | 如果是上海一，请填写"cn-east-3"；如果是北京四，请填写"cn-north-4";如果是华南广州，请填写"cn-south-4"                                                                                                                                    |
      
   
   
 
#### 更多
项目源码及更多详细的使用指导请参考[华为云开发者 Node.js 软件开发工具包（Node.js SDK）](https://github.com/huaweicloud/huaweicloud-sdk-nodejs-v3/blob/master/README_CN.md)。
推荐您使用API在线调试工具[API Explorer](https://console.huaweicloud.com/apiexplorer/#/apidoc/IoTDA) ，API Explorer 支持快速调试和检索，调试API的同时，可以根据您的参数实时生成各种开发语言的SDK示例代码，方便您直接根据示例代码使用SDK。