快速入门
更新时间:2023-04-03
本章将学到如何用SMS Java SDK完成一些基本的操作。
综述
使用本SDK可以完成短信发送、模板申请、模板查询等SMS服务,所有操作都是通过SmsClient与SMS服务进行交互;
具体接口参数定义详细请参考API文档。
确认Endpoint
在确认您使用SDK时配置的Endpoint时,可先阅读开发人员指南中关于SMS访问域名的部分,理解Endpoint相关的概念。区域的概念请参考区域选择说明。
在开始SDK使用之前,需要您先确定好要在哪个区域进行操作,从而在配置SmsClient时将区域对应的Endpoint做为参数填入。
获取密钥
要使用百度智能云产品,您需要拥有一个百度智能云账号和一个有效的 AK(Access Key ID)、SK(Secret Access Key)用来进行签名认证。
可以通过如下步骤获得并了解您的AK/SK信息:
2.创建AK/SK
获取到密钥后,需要在配置Client时做为参数填入。SDK集成了鉴权认证机制,您不需要关心鉴权背后的运算方法,只需要将AK/SK按要求填入对应的位置,SDK将自动为您完成鉴权相关的工作。
发送短信示例
描述
本示例完成了SMS短信发送功能。
代码示例
其中ACCESS_KEY_ID(AK)、SECRET_ACCESS_KEY(SK)获取参考:https://cloud.baidu.com/doc/Reference/s/9jwvz2egb
import com.baidubce.auth.DefaultBceCredentials;
import com.baidubce.services.sms.SmsClient;
import com.baidubce.services.sms.SmsClientConfiguration;
import com.baidubce.services.sms.model.SendMessageV3Request;
import com.baidubce.services.sms.model.SendMessageV3Response;
import java.util.HashMap;
import java.util.Map;
public class TestSmsv3 {
public static void main(String... args) {
String ACCESS_KEY_ID = "your access key";
String SECRET_ACCESS_KEY = "your secret key";
String ENDPOINT = "http://smsv3.bj.baidubce.com";
SmsClientConfiguration config = new SmsClientConfiguration();
config.setCredentials(new DefaultBceCredentials(ACCESS_KEY_ID, SECRET_ACCESS_KEY));
config.setEndpoint(ENDPOINT);
SmsClient client = new SmsClient(config);
SendMessageV3Request request = new SendMessageV3Request();
request.setMobile("13800138000");
request.setSignatureId("sms-signQxkiwz88470");
request.setTemplate("sms-tmpl-awKvRY85349");
Map<String, String> contentVar = new HashMap<>();
contentVar.put("code", "23456");
contentVar.put("minute", "1");
request.setContentVar(contentVar);
SendMessageV3Response response = client.sendMessage(request);
// 解析请求响应 response.isSuccess()为true 表示成功
if (response != null && response.isSuccess()) {
// submit success
} else {
// fail
}
}
}