为方便您更好地使用火山引擎短信服务,我们为开发者封装了SDK for Java,开发者可通过下载SDK直接调用短信服务。
以下将以SendSms接口为例,为您介绍如何下载SDK,并调用短信服务向收件人发送短信。
安装了Maven
Maven 是一个功能强大的工具,支持将依赖项导入到项目中并自动管理依赖项。
获取了AK (Access Key) 和 SK (Secret Key)
小贴士:一个火山引擎账号最多可以同时申请两对 AK/SK 。
SDK for Java 提供了示例 SendSmsDemo.java ,以便开发者可以快速调用SendSms API。
您可以根据以下步骤下载SDK:
方式一:git clone
https://github.com/volcengine/volc-sdk-java.git
方式二:
点击 Code -> Download ZIP
在 IDE 中,将 SDK 中的示例文件夹作为 Maven 项目打开,则以下 Maven 依赖项已添加到 pom.xml 文件中,因此您无需再次添加。 但如果您想将SDK集成到自己的项目中,则需要执行此步骤。 一旦添加到 Maven pom.xml 文件,依赖项将自动下载、更新,并由 Maven 管理其子依赖项。
<dependency>
<groupId>com.volcengine</groupId>
<artifactId>volc-sdk-java</artifactId>
<version>1.0.105</version>
</dependency>
打开示例文件
要通过 AK/SK 设置身份验证。可以按照下面的示例在示例文件中填写您的 AK 和 SK。
推荐按照以下方式设置身份验证:
SmsService smsService = SmsServiceImpl.getInstance(new SmsServiceInfoConfig("ak", "sk"));
package com.volcengine.example.sms;
import com.alibaba.fastjson.JSON;
import com.volcengine.model.request.SmsSendRequest;
import com.volcengine.model.response.SmsSendResponse;
import com.volcengine.service.sms.SmsService;
import com.volcengine.service.sms.SmsServiceInfoConfig;
import com.volcengine.service.sms.impl.SmsServiceImpl;
import java.io.IOException;
import java.util.*;
public class SendSmsDemo {
private static SmsService smsService = SmsServiceImpl.getInstance(new SmsServiceInfoConfig("ak", "sk"));
public static void main(String[] args) throws IOException {
SmsSendRequest req = new SmsSendRequest();
req.setPhoneNumbers("136XX08XXXX");
req.setSmsAccount("subaccount");
req.setTemplateId("templateid");
req.setSign("signature");
Map<String,String> param = new HashMap<>();
param.put("content","第一行\n第二行");
req.setTemplateParamByMap(param);
try {
SmsSendResponse response = smsService.sendV2(req);
System.out.println(JSON.toJSONString(response));
} catch (Exception e) {
e.printStackTrace();
}
}
}
短信发送后,您将收到一条包含MessageID的发送成功的响应。响应参数详见SendSms。