阿里云通过API发送短信

您可以根据业务需要和自身情况选择合适的方式调用短信服务API：

• 阿里云OpenAPI 开发者门户
  适用于习惯交互式操作界面的场景，或者初次使用阿里云产品的开发者用户。您可以在OpenAPI开发者门户中调试和获取SDK请求示例。
  
• 短信服务SDK
  支持多种编程语言，包括Java、Go、C#、PHP、Node.js/TypeScript、Python。使用SDK集成短信服务，可提升您使用短信服务的开发效率。
  
• 自定义封装API调用（不推荐）
  阿里云SDK已经封装了签名、超时、重试等机制，我们建议您使用SDK进行集成，降低开发成本。如果您需要自行封装请求来进行API调用，请参见SendSms和签名示例代码。
  

本文将以SDK的方式引导您使用短信服务。您可以先通过OpenAPI 开发者门户，查看、体验短信服务API后，根据本文指引开始集成短信服务API。整体流程：

准备工作

环境配置

本文以Java语言为例，进行后续操作。更多语言及其SDK安装方式，请参见安装与使用教程。

1. 检查Java环境：您的Java版本需高于Java 8。Java环境配置的方法，请参见在Windows搭建Java开发环境。
   
2. 安装SDK：请通过配置Maven依赖，完成短信服务SDK的安装。
   请在您的Maven项目的pom.xml文件中，在标签内添加以下信息并将 the-latest-version 替换为最新版本号。保存后请重新加载Maven依赖。
   
3. 配置环境变量：为避免在代码中显式地编码访问密钥（AccessKey）而造成泄露，建议您把AccessKey配置到环境变量，通过环境变量进行读取。配置后请重启或刷新您的编译运行环境，包括IDE、命令行界面、其他桌面应用程序及后台服务，以确保最新的系统环境变量成功加载。
   
4. 配置代理（可选）：如果您需要通过代理服务器访问，可通过SDK进行配置，请参见代理配置。
   

API基本信息

短信服务所提供的API基本信息参见如下：

建议您在调用API接口前，阅读接口参数规范与使用说明。在线调试 | API文档

API调用流程

1. 申请短信资质：使用SubmitSmsQualification接口，资质信息需遵守资质材料说明。资质审核通过后才可以申请短信签名。
   
2. 申请短信签名：使用CreateSmsSign接口，签名信息需遵守短信签名规范。签名审核通过后才可以申请模板。
   
3. 申请短信模板：使用CreateSmsTemplate接口，模板内容需遵守短信模板规范。模板审核通过后才可以发送短信。
   
4. 发送短信：使用SendSms接口，或使用SendBatchSms接口批量发送短信。
   
5. 查看短信发送详情：您可使用接口或回执消息查看短信发送详情。
   
6. 获取用户回复内容：您发送短信后，用户回复的短信内容即为上行短信，需配置回执消息获取。
   

更多接口信息，请参见API概览。

代码示例

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

package com.aliyun.sample; import com.aliyun.teaopenapi.models.Config; import com.aliyun.dysmsapi20170525.Client; import com.aliyun.dysmsapi20170525.models.SendSmsRequest; import com.aliyun.dysmsapi20170525.models.SendSmsResponse; import static com.aliyun.teautil.Common.toJSONString; public class Sample { public static Client createClient() throws Exception { Config config = new Config() // 配置 AccessKey ID，请确保代码运行环境设置了环境变量。 .setAccessKeyId(System.getenv('ALIBABA_CLOUD_ACCESS_KEY_ID')) // 配置 AccessKey Secret，请确保代码运行环境设置了环境变量。 .setAccessKeySecret(System.getenv('ALIBABA_CLOUD_ACCESS_KEY_SECRET')); // System.getenv()方法表示获取系统环境变量，请配置环境变量后，在此填入环境变量名称，不要直接填入AccessKey信息。// 配置 Endpoint config.endpoint = 'dysmsapi.aliyuncs.com'; return new Client(config); } public static void main(String[] args) throws Exception { // 初始化请求客户端 Client client = Sample.createClient(); // 构造请求对象，请填入请求参数值 SendSmsRequest sendSmsRequest = new SendSmsRequest() .setPhoneNumbers('1390000****') .setSignName('阿里云') .setTemplateCode('SMS_15305****') .setTemplateParam('{\'name\':\'张三\',\'number\':\'1390000****\'}'); // 获取响应对象 SendSmsResponse sendSmsResponse = client.sendSms(sendSmsRequest); // 响应包含服务端响应的 body 和 headers System.out.println(toJSONString(sendSmsResponse)); } }

您可以访问 OpenAPI 门户，查看各语言 SDK 请求完整示例。如果您需要自行封装请求来进行API调用，请参见SendSms和签名示例代码。