使用JAVA调用短信接口发送验证码短信

注册、登录、找回密码这些场景都离不开短信验证码。这篇文章讲怎么用 Java 调用短信接口，发送单条短信。接口选用智慧云信的 https://api.3yit.com/api/send-sms-single，支持 POST 请求，返回 JSON 格式的结果。

接口地址与调用方式

接口地址为 https://api.3yit.com/api/send-sms-single，请求方式为 POST，请求头 Content-Type 指定为 application/x-www-form-urlencoded。发送请求时需传入 sp_id、mobile、content 等参数，接口返回的 JSON 对象里包含发送状态、消息 ID 等信息。

获取接口参数

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

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

Java 代码实现

发 POST 请求需要用到 HTTP 客户端库，这里选用 Apache 的 HttpClient，它的 HTTP 协议处理能力比较完整。下面是完整的示例代码：

import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.NameValuePair;
import org.apache.http.client.HttpClient;
import org.apache.http.client.entity.UrlEncodedFormEntity;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.impl.client.HttpClientBuilder;
import org.apache.http.message.BasicNameValuePair;
import org.apache.http.util.EntityUtils;
import java.io.IOException;
import java.util.ArrayList;
import java.util.List;
public class SMSSender {
public static void main(String[] args) {
String apiUrl = "https://api.3yit.com/api/send-sms-single";
String spId = "5xxxxx"; // 替换为实际的产品sp_id
String mobile = "176xxxxxxxx"; // 替换为实际的手机号
String content = "【签名】验证码123"; // 替换为实际的短信内容
String signature = "a92569901189fxxxxxxxx957c096c432e2d47635"; // 如果使用签名验证，替换为实际的签名
// String password = md5("your_password_here"); // 如果使用密码验证，替换为实际密码的md5值
try {
sendSMS(apiUrl, spId, mobile, content, signature, null); // 如果使用密码，则传入password，将signature置为null
} catch (IOException e) {
e.printStackTrace();
}
}
public static void sendSMS(String apiUrl, String spId, String mobile, String content, String signature, String password) throws IOException {
HttpClient client = HttpClientBuilder.create().build();
HttpPost post = new HttpPost(apiUrl);
List<NameValuePair> params = new ArrayList<>();
params.add(new BasicNameValuePair("sp_id", spId));
params.add(new BasicNameValuePair("mobile", mobile));
params.add(new BasicNameValuePair("content", content));
if (signature != null) {
params.add(new BasicNameValuePair("signature", signature));
} else if (password != null) {
params.add(new BasicNameValuePair("password", password));
}
// 如果需要，可以添加其他参数，如ext
post.setEntity(new UrlEncodedFormEntity(params));
post.setHeader("Content-Type", "application/x-www-form-urlencoded");
HttpResponse response = client.execute(post);
HttpEntity entity = response.getEntity();
if (entity != null) {
String result = EntityUtils.toString(entity);
System.out.println(result); // 打印返回的JSON结果
// 这里可以解析返回的JSON，获取发送状态、消息ID等信息
// ...
}
}
// 这里可以添加md5加密方法，如果需要的话
// ...
}

注意事项

• 实际使用时，把 sp_id、mobile、content 等参数替换成自己的值。
• 选择签名验证时，签名算法要与接口文档一致，把签名值替换到代码中对应的变量上。
• 选择密码验证时，把密码做 MD5 加密，再把加密后的值替换到对应变量上。
• 接口返回后，建议解析 JSON 中的 code、msg、msg_id 字段，根据状态码做相应处理。

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

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