Java DEMO
本样例基于 Apache HttpClient v4.3, 可下载完整样例项目。 同时,也可 下载基于 3.1 版的完整样例项目。样例项目包含代码、依赖 jar 包和 pom.xml 配置。Windows 用户请注意:下载的代码及说明文件都是 UTF-8 格式编码,且换行风格为 Linux 的。用记事本或写字板直接打开显示会不正常。建议将其导入(或复制)到 Eclipse 等 IDE, 并将项目编码格式设置为 UTF-8 后再打开这些文件查看。若直接查看请用 Notepad++、EditPlus 等编辑器。
功能说明:
该接口要求提前在云片后台添加模板,提交短信时,系统会自动匹配审核通过的模板,匹配成功任意一个模板即可发送。
/** * Created by bingone on 15/12/16. */ import org.apache.http.HttpEntity; import org.apache.http.NameValuePair; import org.apache.http.client.entity.UrlEncodedFormEntity; import org.apache.http.client.methods.CloseableHttpResponse; import org.apache.http.client.methods.HttpPost; import org.apache.http.impl.client.CloseableHttpClient; import org.apache.http.impl.client.HttpClients; import org.apache.http.message.BasicNameValuePair; import org.apache.http.util.EntityUtils; import java.io.IOException; import java.net.URISyntaxException; import java.net.URLEncoder; import java.util.ArrayList; import java.util.HashMap; import java.util.List; import java.util.Map; /** * 短信http接口的java代码调用示例 * 基于Apache HttpClient 4.3 * * @author songchao * @since 2015-04-03 */ public class JavaSmsApi { //查账户信息的http地址 private static String URI_GET_USER_INFO = "https://sms.yunpian.com/v2/user/get.json"; //智能匹配模板发送接口的http地址 private static String URI_SEND_SMS = "https://sms.yunpian.com/v2/sms/single_send.json"; //模板发送接口的http地址 private static String URI_TPL_SEND_SMS = "https://sms.yunpian.com/v2/sms/tpl_single_send.json"; //发送语音验证码接口的http地址 private static String URI_SEND_VOICE = "https://voice.yunpian.com/v2/voice/send.json"; //绑定主叫、被叫关系的接口http地址 private static String URI_SEND_BIND = "https://call.yunpian.com/v2/call/bind.json"; //解绑主叫、被叫关系的接口http地址 private static String URI_SEND_UNBIND = "https://call.yunpian.com/v2/call/unbind.json"; //编码格式。发送编码格式统一用UTF-8 private static String ENCODING = "UTF-8"; public static void main(String[] args) throws IOException, URISyntaxException { //修改为您的apikey.apikey可在官网(http://www.yunpian.com)登录后获取 String apikey = "xxxxxxxxxxxxxxxxxxxxx"; //修改为您要发送的手机号 String mobile = "130xxxxxxxx"; /**************** 查账户信息调用示例 *****************/ System.out.println(JavaSmsApi.getUserInfo(apikey)); /**************** 使用智能匹配模板接口发短信(推荐) *****************/ //设置您要发送的内容(内容必须和某个模板匹配) String text = "【云片网】您的验证码是1234"; //发短信调用示例 // System.out.println(JavaSmsApi.sendSms(apikey, text, mobile)); /**************** 使用指定模板接口发短信(不推荐,建议使用智能匹配模板接口) ******/ //设置模板ID,如您后台报备的模板ID为376861,模板内容为:【云片网】您的验证码是#code#,#min#分钟内有效。 long tpl_id = 376861; //设置对应的模板变量值 String tpl_value = URLEncoder.encode("#code#", ENCODING) + "=" + URLEncoder.encode("1234", ENCODING) + "&" + URLEncoder.encode( "#min#", ENCODING) + "=" + URLEncoder.encode("5", ENCODING); //模板发送的调用示例 System.out.println(tpl_value); System.out.println(JavaSmsApi.tplSendSms(apikey, tpl_id, tpl_value, mobile)); /**************** 使用接口发语音验证码 *****************/ String code = "1234"; //System.out.println(JavaSmsApi.sendVoice(apikey, mobile ,code)); /**************** 使用接口绑定主被叫号码 *****************/ //String from = "+86130xxxxxxxx"; //String to = "+86131xxxxxxxx"; //Integer duration = 30 * 60; // 绑定30分钟 //System.out.println(JavaSmsApi.bindCall(apikey, from ,to , duration)); /**************** 使用接口解绑主被叫号码 *****************/ //System.out.println(JavaSmsApi.unbindCall(apikey, from, to)); } /** * 取账户信息 * * @return json格式字符串 * @throws java.io.IOException */ public static String getUserInfo(String apikey) throws IOException, URISyntaxException { Map < String, String > params = new HashMap < String, String > (); params.put("apikey", apikey); return post(URI_GET_USER_INFO, params); } /** * 智能匹配模板接口发短信 * * @param apikey apikey * @param text 短信内容 * @param mobile 接受的手机号 * @return json格式字符串 * @throws IOException */ public static String sendSms(String apikey, String text, String mobile) throws IOException { Map < String, String > params = new HashMap < String, String > (); params.put("apikey", apikey); params.put("text", text); params.put("mobile", mobile); return post(URI_SEND_SMS, params); } /** * 通过模板发送短信(不推荐) * * @param apikey apikey * @param tpl_id 模板id * @param tpl_value 模板变量值 * @param mobile 接受的手机号 * @return json格式字符串 * @throws IOException */ public static String tplSendSms(String apikey, long tpl_id, String tpl_value, String mobile) throws IOException { Map < String, String > params = new HashMap < String, String > (); params.put("apikey", apikey); params.put("tpl_id", String.valueOf(tpl_id)); params.put("tpl_value", tpl_value); params.put("mobile", mobile); return post(URI_TPL_SEND_SMS, params); } /** * 通过接口发送语音验证码 * @param apikey apikey * @param mobile 接收的手机号 * @param code 验证码 * @return */ public static String sendVoice(String apikey, String mobile, String code) { Map < String, String > params = new HashMap < String, String > (); params.put("apikey", apikey); params.put("mobile", mobile); params.put("code", code); return post(URI_SEND_VOICE, params); } /** * 通过接口绑定主被叫号码 * @param apikey apikey * @param from 主叫 * @param to 被叫 * @param duration 有效时长,单位:秒 * @return public static String bindCall(String apikey, String from, String to, Integer duration) { Map < String, String > params = new HashMap < String, String > (); params.put("apikey", apikey); params.put("from", from); params.put("to", to); params.put("duration", String.valueOf(duration)); return post(URI_SEND_BIND, params); } * 通过接口解绑绑定主被叫号码 * @param apikey apikey * @param from 主叫 * @param to 被叫 * @return public static String unbindCall(String apikey, String from, String to) { Map < String, String > params = new HashMap < String, String > (); params.put("apikey", apikey); params.put("from", from); params.put("to", to); return post(URI_SEND_UNBIND, params); } */ /** * 基于HttpClient 4.3的通用POST方法 * * @param url 提交的URL * @param paramsMap 提交<参数,值>Map * @return 提交响应 */ public static String post(String url, Map < String, String > paramsMap) { CloseableHttpClient client = HttpClients.createDefault(); String responseText = ""; CloseableHttpResponse response = null; try { HttpPost method = new HttpPost(url); if (paramsMap != null) { List < NameValuePair > paramList = new ArrayList < NameValuePair > (); for (Map.Entry < String, String > param: paramsMap.entrySet()) { NameValuePair pair = new BasicNameValuePair(param.getKey(), param.getValue()); paramList.add(pair); } method.setEntity(new UrlEncodedFormEntity(paramList, ENCODING)); } response = client.execute(method); HttpEntity entity = response.getEntity(); if (entity != null) { responseText = EntityUtils.toString(entity, ENCODING); } } catch (Exception e) { e.printStackTrace(); } finally { try { response.close(); } catch (Exception e) { e.printStackTrace(); } } return responseText; } }