使用JSP调用短信接口发送验证码短信教程

注册新账号、找回密码、支付验证，这些场景都会用到短信验证码。这篇文章讲怎么在 JSP（Java Server Pages）环境下调用短信接口，把验证码短信发出去。

准备工作

开始之前，先确认已经拿到短信服务商（如智慧云信）的开发者账号，并在文档里找到自己的 sp_id 和 password（或 signature）。

获取接口参数

登录智慧云信官网，选择对应的产品（如【验证码】），在上方选项卡中点击【开发者】→【HTTP开发文档】，就能看到具体的 API 方法名称，以及各参数的 key 和对应值，通常包括 sp_id、mobile、content、password 等。各参数含义如下：

• sp_id：产品编号，全局唯一，一般由 6 位数字组成。
• mobile：接收短信的手机号码。
• content：短信内容，包含签名和正文。例如“【智慧云信】您的验证码是456790，请妥善保管”，其中【智慧云信】是签名，需在签名报备中申请；后面的提示语是短信模板，需在模板报备中申请，审核通过后才能发送。
• password：用 SP_ID 密码经 MD5 加密后生成的接口密码（非登录密码），由 32 位随机字符串组成。

编写 JSP 页面

在 JSP 页面里用 Java 代码发送 HTTP POST 请求到短信接口，下面是示例：

<%@ page import="java.io.*,java.net.*,java.util.HashMap,java.util.Map" %>
<%
// 设置请求参数
String spId = "5xxxxx"; // 从开发者文档中获取
String mobile = "176xxxxxxxx"; // 接收验证码的手机号
String content = "【签名】验证码123"; // 短信内容，其中验证码需动态生成
String password = "xxxxxxxxxxx"; // 32位MD5处理后的密码，从开发者文档中获取
// 签名和密码二选一，这里以密码为例
// 构造请求URL和参数
String url = "https://api.3yit.com/api/send-sms-single";
Map<String, String> params = new HashMap<>();
params.put("sp_id", spId);
params.put("mobile", mobile);
params.put("content", content);
params.put("password", password);
// 发送POST请求
String response = sendPostRequest(url, params);
// 解析返回结果
JSONObject jsonObject = new JSONObject(response); // 假设你已经导入了JSONObject库
int code = jsonObject.getInt("code");
String msg = jsonObject.getString("msg");
String msgId = jsonObject.getString("msg_id");
// 输出结果到页面
out.println("发送结果：<br>");
out.println("Code: " + code + "<br>");
out.println("Msg: " + msg + "<br>");
out.println("Msg ID: " + msgId + "<br>");
%>
<%!
// 发送POST请求的方法
public String sendPostRequest(String url, Map<String, String> params) {
StringBuilder postData = new StringBuilder();
for (Map.Entry<String, String> param : params.entrySet()) {
if (postData.length() != 0) postData.append('&');
postData.append(URLEncoder.encode(param.getKey(), "UTF-8"));
postData.append('=');
postData.append(URLEncoder.encode(param.getValue(), "UTF-8"));
}
byte[] postDataBytes = postData.toString().getBytes("UTF-8");
HttpURLConnection conn = null;
try {
URL obj = new URL(url);
conn = (HttpURLConnection) obj.openConnection();
conn.setRequestMethod("POST");
conn.setRequestProperty("Content-Type", "application/x-www-form-urlencoded");
conn.setRequestProperty("Content-Length", String.valueOf(postDataBytes.length));
conn.setDoOutput(true);
try (OutputStream os = conn.getOutputStream()) {
os.write(postDataBytes);
}
try (BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()))) {
String inputLine;
StringBuilder response = new StringBuilder();
while ((inputLine = in.readLine()) != null) {
response.append(inputLine);
}
return response.toString();
}
} catch (IOException e) {
e.printStackTrace();
} finally {
if (conn != null) {
conn.disconnect();
}
}
return null;
}
%>

注意事项

• 验证码要在业务端动态生成，保证唯一性和安全性，不要把写死的验证码发出去。
• 防止短信轰炸：对发送频率做限制，并加黑名单功能。
• 签名和密码按服务商要求二选一，本示例以密码为例，签名算法也是常见的验证方式。
• 处理返回结果时，根据 code 的值做错误处理，不要只判断 msg 是否为 success。

其他语言教程：PHP · Java · ASP · ASP.NET(C#) · Node.js · Delphi · Go · Python · Ruby · Shell · VB · C++ · C。更多信息见短信API接入指南。

代码里的 API 地址、账号和密码替换成你自己的就能跑通。如果还没有账号，去智慧云信官网注册一个，注册就能免费测试，验证码、通知、营销短信都支持。