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

使用Java调用短信接口发送单条短信

在现代应用开发中，短信服务因其即时性和有效性而得到广泛应用。本文将详细介绍如何使用Java编程语言来调用短信接口，发送单条短信。我们将基于智慧云信的短信服务接口https://api.3yit.com/api/send-sms-single，该接口支持POST请求，并以JSON格式返回结果。

一、接口概述

该短信接口支持发送单条短信，要求使用POST方法，请求头中指定Content-Type为application/x-www-form-urlencoded。接口地址是https://api.3yit.com/api/send-sms-single，发送请求时需要传递若干参数，包括sp_id、mobile、content等。接口返回的结果是一个JSON对象，包含了发送状态、消息ID等信息。

二、参数获取

登录智慧云信官网、点击对应的产品，比如【验证码】、在上方的选项卡中选择【开发者】-》【HTTP开发文档】。从文档中可以看到具体API方法名称，以及各个参数key及对应的值vavlue，通常包括sp_id、mobile、content、password等参数。    

sp_id代表产品编号，具有唯一性，通常是由6位数字组成。

mobile代表手机号码。

content代表短信内容，包含签名与短信内容，比如“【智慧云信】您的验证码是456790，请妥善保管”，其中【智慧云信】是签名，在签名报备中申请，“您的验证码是456790，请妥善保管“是短信模版，在模版报备中申请，审核通过即可发送。

password是通过SP_ID密码进行MD5加密算法后产生的接口密码（非登录密码），由32位随机字符串组成。

三、Java代码实现

首先，我们需要使用Java的HTTP客户端库来发送POST请求。这里我们选择使用Apache的HttpClient库，它提供了丰富的HTTP协议处理能力。

java复制代码

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加密方法，如果需要的话  

// ...  

}

四、注意事项

1. 在实际使用中，需要将sp_id、mobile、content等参数替换为实际的值。
2. 如果选择使用签名验证，需要确保签名的生成算法与接口文档中的要求一致，并将签名值替换到代码中对应的变量上。如果选择使用密码验证，需要将密码进行MD5加密，并将加密后的值替换到