Node.js SDK使用指南

MSGSMS提供Node.js语言的应用侧SDK供开发者使用。本文介绍Node.js SDK的安装和配置，及使用Node.js SDK调用API参考的示例，您可以参考本章节进行快速集成开发。

开发前准备

已注册华为账号并开通华为云，完成企业实名认证。
已具备Node.js开发环境，支持Node 10.16.1及以上版本。
已获取华为云账号对应的Access Key（AK）和Secret Access Key（SK）。
请在华为云控制台“我的凭证 > 访问密钥”页面上创建和查看您的AK/SK。具体请参见访问密钥。
已获取MSGSMS服务对应区域的项目ID。
请在华为云控制台“我的凭证 > API凭证”页面上查看项目ID。具体请参见API凭证。

安装SDK

执行如下命令安装华为云Node.js SDK相关依赖库：

npm install @huaweicloud/huaweicloud-sdk-core
npm install @huaweicloud/huaweicloud-sdk-msgsms

代码示例

以调用创建短信应用接口为例，以下代码示例向您展示使用Node.js SDK的主要步骤：

创建认证。
创建MsgsmsClient实例并初始化。
实例化请求对象。

调用创建短信应用接口。

const core = require('@huaweicloud/huaweicloud-sdk-core');
const msgsms = require("@huaweicloud/huaweicloud-sdk-msgsms/v2/public-api");

// 认证用的ak和sk直接写到代码中有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全。
// 本示例以ak和sk保存在环境变量中为例，运行本示例前请先在本地环境中设置环境变量CLOUD_SDK_AK和CLOUD_SDK_SK。
const ak = process.env.CLOUD_SDK_AK;
const sk = process.env.CLOUD_SDK_SK;
const endpoint = "https://msgsms.cn-north-4.myhuaweicloud.com";
const project_id = "";

// 创建认证
const credentials = new core.BasicCredentials()
                     .withAk(ak)
                     .withSk(sk)
                     .withProjectId(project_id)
// 创建MsgsmsClient实例并初始化
const client = msgsms.MsgsmsClient.newBuilder()
                            .withCredential(credentials)
                            .withEndpoint(endpoint)
                            .build();
// 实例化请求对象
const request = new msgsms.CreateAppRequest();
const body = new msgsms.SmsAppAddReq();
request.withBody(body);
// 调用创建短信应用接口
const result = client.createApp(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）。
sk	您的华为云账号秘密访问密钥（Secret Access Key）。
endpoint	请替换为您要访问的MSGSMS服务所在区域的终端节点，在SDK代码MsgsmsRegion.ts中已经定义。
project_id	云服务所在区域的项目ID ，根据您需要操作的项目所属区域选择对应的项目ID。