阿里云短信服务Java SDK提供发送短信、管理模板签名等功能。 - 短信服务

阿里云短信服务 SDK for Java 是阿里云提供的官方Java SDK，用于调用阿里云短信服务API。帮助开发者快速集成短信服务到自己的应用中。

安装

系统要求

Java版本：请检查您的Java版本是否高于Java 8。Java环境配置的方法，请参见在Windows搭建Java开发环境。
操作系统：Windows/Linux/macOS（无特殊要求）。
其他依赖：Maven 3.0+（用于构建项目）。

使用 Maven 安装

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>dysmsapi20180501</artifactId>
    <!-- 请将 'the-latest-version' 替换为最新版本号：https://mvnrepository.com/artifact/com.aliyun/dysmsapi20180501 -->
  <version>the-latest-version</version>
</dependency>

认证配置

步骤一：创建RAM用户并完成授权

重要

阿里云主账号拥有较高权限，建议您通过RAM用户进行API调用和日常运维。有关RAM用户的更多信息，请参见RAM用户概览。

创建RAM用户：访问创建RAM用户，完成相关名称设置，并选择访问配置为使用永久 AccessKey 访问，单击确定后即可完成RAM用户的创建。请及时保存AccessKey信息。
为RAM用户授权：访问RAM用户列表，找到您所创建的RAM用户，单击操作列的新增授权。在权限策略文本搜索框中输入AliyunDysmsFullAccess后选中此策略，单击确认新增授权，即可完成授权操作。

说明

AliyunDysmsFullAccess：管理短信服务的权限。
AliyunDysmsReadOnlyAccess：只读访问短信服务的权限。
如果您需要新建自定义权限，请参见授权信息。

步骤二：获取访问凭证

请配置环境变量，通过环境变量读取访问密钥（AccessKey）。环境变量配置方法，请参见在Linux、macOS和Windows系统配置环境变量。

说明

为避免在代码中硬编码AccessKey而造成泄露，请通过配置环境变量的方式，来获取AccessKey。
本文代码示例以环境变量名ALIBABA_CLOUD_ACCESS_KEY_ID和ALIBABA_CLOUD_ACCESS_KEY_SECRET为例，进行后续操作。

安全最佳实践

使用环境变量或密钥管理服务存储凭证。
定期轮换访问密钥。
遵循最小权限原则，为RAM用户分配最小必要权限。
不要在日志中打印凭证信息。
在生产环境中使用RAM角色而非主账号凭证。

快速开始

代码示例

使用SDK调用发送短信API的代码示例如下，请根据注释完成参数填写。

package com.aliyun.sample;

import com.aliyun.teaopenapi.models.Config;
import com.aliyun.dysmsapi20180501.Client;
import com.aliyun.dysmsapi20180501.models.SendMessageToGlobeRequest;
import com.aliyun.dysmsapi20180501.models.SendMessageToGlobeResponse;
import static com.aliyun.teautil.Common.toJSONString;

public class Sample {
    public static Client createClient() throws Exception {
        Config config = new Config()
                // 配置 AccessKey ID，请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID。
                .setAccessKeyId(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"))
                // 配置 AccessKey Secret，请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_SECRET。
                .setAccessKeySecret(System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET"));

        // 配置 Endpoint
        config.endpoint = "dysmsapi.ap-southeast-1.aliyuncs.com";

        return new Client(config);
    }

    public static void main(String[] args) throws Exception {
        // 初始化请求客户端
        Client client = Sample.createClient();

        // 构造请求对象，请填入请求参数值
        SendMessageToGlobeRequest sendSmsRequest = new SendMessageToGlobeRequest()
                .setTo("<YOUR_VALUE>")
                .setMessage("<YOUR_VALUE>");

        // 获取响应对象
        SendMessageToGlobeResponse sendSmsResponse = client.sendMessageToGlobe(sendSmsRequest);

        // 响应包含服务端响应的 body 和 headers
        System.out.println(toJSONString(sendSmsResponse));
    }
}

下载示例代码

也可以下载示例代码，直接运行。

访问SendMessageToGlobe。
在左侧的参数配置页签，填写需要的参数信息，填写示例如下：

To 参数输入示例值：88691567****
Message 参数输入示例值：这是一条测试短信

在右侧的SDK示例页签，SDK版本选择v2.0，语言选择Java语言（按需选择Java和Java异步），单击下载完整工程按钮，下载示例代码包。
解压后使用IDE加载项目，待相关依赖加载完毕后，打开 src/main/java/com/aliyun/sample/Sample.java。

运行项目

项目运行后可查看到输出，本示例中的返回内容如下：

{
  "headers": {
    "date": "Tue, 24 Oct 2023 07:47:17 GMT",
    "content-type": "application/json;charset=utf-8",
    "content-length": "263",
    "connection": "keep-alive",
    "keep-alive": "timeout=25",
    "access-control-allow-origin": "*",
    "access-control-expose-headers": "*",
    "x-acs-request-id": "97B1D7B6-F2F6-3A50-97BC-A90B43EC962F",
    "x-acs-trace-id": "29c11fe4c778b74774d5f5602f0e7975",
    "etag": "2a+mcDRTDkXqx9VF7b6U57Q3"
  },
  "statusCode": 200,
  "body": {
    "ResponseCode": "OK",
    "NumberDetail": {
    "Region": "Taiwan",
    "Country": "Taiwan, Province of China",
    "Carrier": "FarEasTone"
  },
    "RequestId": "97B1D7B6-F2F6-3A50-97BC-A90B43EC962F",
    "Segments": "1",
    "ResponseDescription": "OK",
    "To": "88691567****",
    "MessageId": "191921698133637273"
  }
}

最佳实践总结

性能优化

使用连接池复用HTTP连接，减少连接建立开销。
对于高频调用，考虑使用异步调用模式。
合理设置超时时间，避免长时间等待影响业务性能。
批量操作时，充分利用API的批量处理能力。

安全建议

始终使用HTTPS协议与API通信。
敏感信息（如手机号、验证码）不要记录在日志中。
对用户输入的手机号进行格式验证，防止恶意输入。
使用阿里云提供的STS临时凭证替代长期凭证。

资源管理

及时关闭不再使用的客户端连接。
对于大量并发请求，合理配置线程池大小。
监控API调用频率，避免超出QPS限制。

短信服务：Java SDK调用示例

安装