功能介绍

什么是华为云MSGSMS服务？

华为云MSGSMS服务为企业用户（不包括个体工商户、个人独资企业、合伙企业等非法人主体或组织）提供单发、群发短信服务，同时可接收用户回复短信。

MSGSMS服务提供的短信发送能力，包括国内短信和国际/港澳台短信，具体如下：

• 国内短信：向中国大陆号码发送短信。支持发送验证码、通知和推广短信。国内短信支持三网合一（移动，联通，电信，新增支持广电）专属通道。

• 国际短信：向国际/港澳台号码发送英文及其他语种短信。仅支持发送验证码和通知短信。 注：国际/港澳台短信无签名，模板不区分类型，不可接收用户回复短信。

短信发送形式：可开发代码调用API，或使用群发助手发送短信。

企业客户在发送短信前，需要先通过MSGSMS服务的Console或API创建短信应用、短信模板，国内短信业务还需要创建短信签名。

• 短信应用：短信应用是用户使用华为公有云短信服务的载体。创建应用后，系统会自动分配全局唯一的APP_Key和APP_Secret、APPID（应用主键ID），并提供APP接入地址。其中，APP_Key和APP_Secret是用户身份的唯一标识，调用短信业务API时需携带，用于认证鉴权。APPID是后续调用签名管理、模板管理相关接口所需的参数。

• 短信签名：短信签名是根据用户身份来创建的符合自身属性的签名信息，需审核通过后才能使用。短信签名只针对国内短信场景使用。 例如，手机终端收到的短信为“【华为云】您的验证码为：123456（5分钟内有效），为了保证您的账户安全，请勿向任何人提供此验证码”，其中，“【华为云】”为短信签名。

• 短信模板：短信模板是用户发送短信时使用的内容模板，由纯固定文本或固定文本加变量组成。模板创建后，只有变量可以按规则变化，替换成符合格式要求的指定内容。

您将学到什么？

华为云提供了 MSGSMS 服务端 SDK，您可以直接集成服务端 SDK 来调用 MSGSMS 的相关 API，从而实现对 MSGSMS 的快速操作。

该场景示例代码以短信应用为例，介绍如何使用MSGSMS Java SDK创建短信应用、更新短信应用及获取应用详情。创建的应用可用于后续创建短信签名及短信模板使用。

前置条件

• 1、需要是华为云企业认证账号，并开通华为云MSGSMS云服务。
• 2、获取华为云开发工具包（SDK），华为云提供了多种语言的SDK。本示例代码使用了Java SDK，也给出了在Java项目的pom.xml文件引入依赖的示例。
• 3、您需要拥有华为云账号以及该账号对应的 Access Key（AK）、Secret Access Key（SK）和IAM项目ID（PROJECT ID）。获取方法可参考获取帐号、用户、项目的名称和ID。

接口参数说明

场景示例代码是基于SDK开发的，其中涉及到的Restful API接口与示例代码SDK接口对应关系如下：

相关接口参数的详细说明可参见：“短信应用API” 。

SDK获取和安装

开发者可以通过Maven方式获取和安装SDK，包括“huaweicloud-sdk-core”和“huaweicloud-sdk-msgsms”。需要在Java项目的pom.xml文件中加入如下的依赖项。

                    
                    Copied!
                
<dependency>
    <groupId>com.huaweicloud.sdk</groupId>
    <artifactId>huaweicloud-sdk-msgsms</artifactId>
    <version>3.1.38</version>
</dependency>

示例代码

                    
                    Copied!
                
public class MsgsmsAppManageDemo {
  public static void main(String[] args) {
    System.out.println("Start HUAWEI CLOUD MSGSMS App Manage Java Demo...");
    // 认证用的ak和sk硬编码到代码中或者明文存储都有很大的安全风险，建议在配置文件或者环境变量中密文存放，使用时解密，确保安全；
    // 本示例以ak和sk保存在环境变量中来实现身份认证为例，运行示例前请先在本地环境中设置环境变量HUAWEICLOUD_SDK_AK和HUAWEICLOUD_SDK_SK。
    String ak = System.getenv("HUAWEICLOUD_SDK_AK");
    String sk = System.getenv("HUAWEICLOUD_SDK_SK");

    ICredential auth = getCredential(ak, sk,"YOUR PROJECT ID");

    // 创建MsgsmsClient实例
    MsgsmsClient client = getClient(MsgsmsRegion.CN_NORTH_4, auth);

    try {
      String appId = createApp(client);
      showApp(client, appId);
      updateApp(client, appId);
    } catch (ConnectionException | RequestTimeoutException e) {
      System.out.println(e.getMessage());
    } catch (ServiceResponseException e) {
      System.out.println(e.getHttpStatusCode());
      System.out.println(e.getErrorCode());
      System.out.println(e.getErrorMsg());
    }
  }

  /**
   * 创建短信应用
   * @param client MsgsmsClient实例
   * @return 应用主键ID
   */
  private static String createApp(MsgsmsClient client) {
    CreateAppRequest request = new CreateAppRequest();
    SmsAppAddReq body = new SmsAppAddReq();
    body.setAppName("myTestApp");
    body.setRegion("cn");
    body.setEnterpriseProjectId("0");
    body.setEnterpriseProjectName("default");
    request.withBody(body);

    // 调用SDK的接口创建应用
    CreateAppResponse response = client.createApp(request);
    System.out.println(response.toString());
    return response.getId();
  }

  /**
   * 获取应用详情
   * @param client MsgsmsClient实例
   * @param appId 应用主键ID
   */
  private static void showApp(MsgsmsClient client, String appId) {
    ShowAppRequest request = new ShowAppRequest();
    request.setId(appId);

    // 调用SDK的接口获取应用详情
    ShowAppResponse response = client.showApp(request);
    System.out.println(response.toString());
  }

  /**
   * 更新短信应用
   * @param client MsgsmsClient实例
   * @param appId 应用主键ID
   */
  private static void updateApp(MsgsmsClient client, String appId) {
    UpdateAppRequest request = new UpdateAppRequest();
    SmsAppUpdateReq body = new SmsAppUpdateReq();
    body.setAppName("myTestAppNew");
    body.setRegion("cn");
    body.setEnterpriseProjectId("0");
    body.setEnterpriseProjectName("default");

    request.withBody(body);
    request.setId(appId);

    // 调用SDK的接口更新应用
    UpdateAppResponse response = client.updateApp(request);
    System.out.println(response.toString());
  }

  /**
   * 创建鉴权凭证
   * @param ak 租户账号对应的Access Key (AK)
   * @param sk 租户账号对应的Secret Access Key (SK)
   * @param projectId 租户账号对应的IAM项目ID
   * @return 鉴权凭证
   */
  public static ICredential getCredential(String ak, String sk, String projectId) {
    return new BasicCredentials()
            .withAk(ak)
            .withSk(sk)
            .withProjectId(projectId);
  }

  /**
   * 创建Msgsms client
   * @param region region信息
   * @param auth 鉴权凭证
   * @return MsgsmsClient实例
   */
  public static MsgsmsClient getClient(Region region, ICredential auth) {
    // 使用默认配置
    HttpConfig config = HttpConfig.getDefaultHttpConfig();
    config.withIgnoreSSLVerification(true);

    // 初始化Msgsms服务的客户端
    return MsgsmsClient.newBuilder()
            .withHttpConfig(config)
            .withCredential(auth)
            .withRegion(region)
            .build();
  }
}

参考

更多信息请参考：

• 1、MSGSMS产品介绍
• 2、MSGSMS快速入门
• 3、MSGSMS开发指南
• 4、API Explorer
• 5、API错误中心
• 6、SDK中心

修订记录