Java DEMO
本樣例基于 Apache HttpClient v4.3, 可下載完整樣例項目。 同時,也可 下載基于 3.1 版的完整樣例項目。樣例項目包含代碼、依賴 jar 包和 pom.xml 配置。Windows 用戶請注意:下載的代碼及說明文件都是 UTF-8 格式編碼,且換行風(fēng)格為 Linux 的。用記事本或?qū)懽职逯苯哟蜷_顯示會不正常。建議將其導(dǎo)入(或復(fù)制)到 Eclipse 等 IDE, 并將項目編碼格式設(shè)置為 UTF-8 后再打開這些文件查看。若直接查看請用 Notepad++、EditPlus 等編輯器。
功能說明:
該接口要求提前在云片后臺添加模板,提交短信時,系統(tǒng)會自動匹配審核通過的模板,匹配成功任意一個模板即可發(fā)送。
/** * 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代碼調(diào)用示例 * 基于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"; //智能匹配模板發(fā)送接口的http地址 private static String URI_SEND_SMS = "https://sms.yunpian.com/v2/sms/single_send.json"; //模板發(fā)送接口的http地址 private static String URI_TPL_SEND_SMS = "https://sms.yunpian.com/v2/sms/tpl_single_send.json"; //發(fā)送語音驗證碼接口的http地址 private static String URI_SEND_VOICE = "https://voice.yunpian.com/v2/voice/send.json"; //綁定主叫、被叫關(guān)系的接口http地址 private static String URI_SEND_BIND = "https://call.yunpian.com/v2/call/bind.json"; //解綁主叫、被叫關(guān)系的接口http地址 private static String URI_SEND_UNBIND = "https://call.yunpian.com/v2/call/unbind.json"; //編碼格式。發(fā)送編碼格式統(tǒng)一用UTF-8 private static String ENCODING = "UTF-8"; public static void main(String[] args) throws IOException, URISyntaxException { //修改為您的apikey.apikey可在官網(wǎng)(http://www.ssjdyy2.com)登錄后獲取 String apikey = "xxxxxxxxxxxxxxxxxxxxx"; //修改為您要發(fā)送的手機號 String mobile = "130xxxxxxxx"; /**************** 查賬戶信息調(diào)用示例 *****************/ System.out.println(JavaSmsApi.getUserInfo(apikey)); /**************** 使用智能匹配模板接口發(fā)短信(推薦) *****************/ //設(shè)置您要發(fā)送的內(nèi)容(內(nèi)容必須和某個模板匹配) String text = "【云片網(wǎng)】您的驗證碼是1234"; //發(fā)短信調(diào)用示例 // System.out.println(JavaSmsApi.sendSms(apikey, text, mobile)); /**************** 使用指定模板接口發(fā)短信(不推薦,建議使用智能匹配模板接口) ******/ //設(shè)置模板ID,如您后臺報備的模板ID為376861,模板內(nèi)容為:【云片網(wǎng)】您的驗證碼是#code#,#min#分鐘內(nèi)有效。 long tpl_id = 376861; //設(shè)置對應(yīng)的模板變量值 String tpl_value = URLEncoder.encode("#code#", ENCODING) + "=" + URLEncoder.encode("1234", ENCODING) + "&" + URLEncoder.encode( "#min#", ENCODING) + "=" + URLEncoder.encode("5", ENCODING); //模板發(fā)送的調(diào)用示例 System.out.println(tpl_value); System.out.println(JavaSmsApi.tplSendSms(apikey, tpl_id, tpl_value, mobile)); /**************** 使用接口發(fā)語音驗證碼 *****************/ 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); } /** * 智能匹配模板接口發(fā)短信 * * @param apikey apikey * @param text 短信內(nèi)容 * @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); } /** * 通過模板發(fā)送短信(不推薦) * * @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); } /** * 通過接口發(fā)送語音驗證碼 * @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 提交<參數(shù),值>Map * @return 提交響應(yīng) */ 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; } }