为方便您更好地使用火山引擎短信服务,我们为开发者封装了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。