java DEMO

本样例基于 Apache HttpClient v4.3 ， 可下载完整样例项目。 同时，也可 下载基于3.1版的完整样例项目。 样例项目包含代码、依赖 jar包和pom.xml配置。Windows用户请注意：下载的代码及说明文件都是UTF-8格式编码，且换行风格为Linux的。 用记事本或写字板直接打开显示会不正常。建议将其导入（或复制）到Eclipse等IDE， 并将项目编码格式设置为UTF-8后再打开这些文件查看。若直接查看请用Notepad++、EditPlus等编辑器。

功能说明：该接口要求提前在云片后台添加模板，提交短信时，系统会自动匹配审核通过的模板，匹配成功任意一个模板即可发送。系统已提供的默认模板添加签名后可以直接使用。

  1. /**
  2.  * Created by bingone on 15/12/16.
  3.  */
  4. import org.apache.http.HttpEntity;
  5. import org.apache.http.NameValuePair;
  6. import org.apache.http.client.entity.UrlEncodedFormEntity;
  7. import org.apache.http.client.methods.CloseableHttpResponse;
  8. import org.apache.http.client.methods.HttpPost;
  9. import org.apache.http.impl.client.CloseableHttpClient;
  10. import org.apache.http.impl.client.HttpClients;
  11. import org.apache.http.message.BasicNameValuePair;
  12. import org.apache.http.util.EntityUtils;
  13. import java.io.IOException;
  14. import java.net.URISyntaxException;
  15. import java.net.URLEncoder;
  16. import java.util.ArrayList;
  17. import java.util.HashMap;
  18. import java.util.List;
  19. import java.util.Map;
  21. /**
  22.  * 短信http接口的java代码调用示例
  23.  * 基于Apache HttpClient 4.3
  24.  *
  25.  * @author songchao
  26.  * @since 2015-04-03
  27.  */
  29. public class JavaSmsApi {
  31.     //查账户信息的http地址
  32.     private static String URI_GET_USER_INFO =
  33.         "https://sms.yunpian.com/v2/user/get.json";
  35.     //智能匹配模板发送接口的http地址
  36.     private static String URI_SEND_SMS =
  37.         "https://sms.yunpian.com/v2/sms/single_send.json";
  39.     //模板发送接口的http地址
  40.     private static String URI_TPL_SEND_SMS =
  41.         "https://sms.yunpian.com/v2/sms/tpl_single_send.json";
  43.     //发送语音验证码接口的http地址
  44.     private static String URI_SEND_VOICE =
  45.         "https://voice.yunpian.com/v2/voice/send.json";
  47.     //绑定主叫、被叫关系的接口http地址
  48.     private static String URI_SEND_BIND =
  49.         "https://call.yunpian.com/v2/call/bind.json";
  51.     //解绑主叫、被叫关系的接口http地址
  52.     private static String URI_SEND_UNBIND =
  53.         "https://call.yunpian.com/v2/call/unbind.json";
  55.     //编码格式。发送编码格式统一用UTF-8
  56.     private static String ENCODING = "UTF-8";
  58.     public static void main(String[] args) throws IOException,
  59.         URISyntaxException {
  61.             //修改为您的apikey.apikey可在官网（http://www.yunpian.com)登录后获取
  62.             String apikey = "xxxxxxxxxxxxxxxxxxxxx";
  64.             //修改为您要发送的手机号
  65.             String mobile = "130xxxxxxxx";
  67.             /**************** 查账户信息调用示例 *****************/
  68.             System.out.println(JavaSmsApi.getUserInfo(apikey));
  70.             /**************** 使用智能匹配模板接口发短信(推荐) *****************/
  71.             //设置您要发送的内容(内容必须和某个模板匹配。以下例子匹配的是系统提供的1号模板）
  72.             String text = "【云片网】您的验证码是1234";
  73.             //发短信调用示例
  74.             // System.out.println(JavaSmsApi.sendSms(apikey, text, mobile));
  76.             /**************** 使用指定模板接口发短信(不推荐，建议使用智能匹配模板接口) ******/
  77.             //设置模板ID，如使用1号模板:【#company#】您的验证码是#code#
  78.             long tpl_id = 1;
  79.             //设置对应的模板变量值
  81.             String tpl_value = URLEncoder.encode("#code#", ENCODING) + "=" +
  82.                 URLEncoder.encode("1234", ENCODING) + "&" + URLEncoder.encode(
  83.                     "#company#", ENCODING) + "=" + URLEncoder.encode("云片网",
  84.                     ENCODING);
  85.             //模板发送的调用示例
  86.             System.out.println(tpl_value);
  87.             System.out.println(JavaSmsApi.tplSendSms(apikey, tpl_id, tpl_value,
  88.                 mobile));
  90.             /**************** 使用接口发语音验证码 *****************/
  91.             String code = "1234";
  92.             //System.out.println(JavaSmsApi.sendVoice(apikey, mobile ,code));
  94.             /**************** 使用接口绑定主被叫号码 *****************/
  95.             //String from = "+86130xxxxxxxx";
  96.             //String to = "+86131xxxxxxxx";
  97.             //Integer duration = 30 * 60; // 绑定30分钟
  98.             //System.out.println(JavaSmsApi.bindCall(apikey, from ,to , duration));
  100.             /**************** 使用接口解绑主被叫号码 *****************/
  101.             //System.out.println(JavaSmsApi.unbindCall(apikey, from, to));
  102.         }
  104.     /**
  105.      * 取账户信息
  106.      *
  107.      * @return json格式字符串
  108.      * @throws java.io.IOException
  109.      */
  111.     public static String getUserInfo(String apikey) throws IOException,
  112.         URISyntaxException {
  113.             Map < String, String > params = new HashMap < String, String > ();
  114.             params.put("apikey", apikey);
  115.             return post(URI_GET_USER_INFO, params);
  116.         }
  118.     /**
  119.      * 智能匹配模板接口发短信
  120.      *
  121.      * @param apikey apikey
  122.      * @param text   　短信内容
  123.      * @param mobile 　接受的手机号
  124.      * @return json格式字符串
  125.      * @throws IOException
  126.      */
  128.     public static String sendSms(String apikey, String text, 
  129.         String mobile) throws IOException {
  130.         Map < String, String > params = new HashMap < String, String > ();
  131.         params.put("apikey", apikey);
  132.         params.put("text", text);
  133.         params.put("mobile", mobile);
  134.         return post(URI_SEND_SMS, params);
  135.     }
  137.     /**
  138.      * 通过模板发送短信(不推荐)
  139.      *
  140.      * @param apikey    apikey
  141.      * @param tpl_id    　模板id
  142.      * @param tpl_value 　模板变量值
  143.      * @param mobile    　接受的手机号
  144.      * @return json格式字符串
  145.      * @throws IOException
  146.      */
  148.     public static String tplSendSms(String apikey, long tpl_id, String tpl_value,
  149.         String mobile) throws IOException {
  150.         Map < String, String > params = new HashMap < String, String > ();
  151.         params.put("apikey", apikey);
  152.         params.put("tpl_id", String.valueOf(tpl_id));
  153.         params.put("tpl_value", tpl_value);
  154.         params.put("mobile", mobile);
  155.         return post(URI_TPL_SEND_SMS, params);
  156.     }
  158.     /**
  159.      * 通过接口发送语音验证码
  160.      * @param apikey apikey
  161.      * @param mobile 接收的手机号
  162.      * @param code   验证码
  163.      * @return
  164.      */
  166.     public static String sendVoice(String apikey, String mobile, String code) {
  167.         Map < String, String > params = new HashMap < String, String > ();
  168.         params.put("apikey", apikey);
  169.         params.put("mobile", mobile);
  170.         params.put("code", code);
  171.         return post(URI_SEND_VOICE, params);
  172.     }
  174.     /**
  175.      * 通过接口绑定主被叫号码
  176.      * @param apikey apikey
  177.      * @param from 主叫
  178.      * @param to   被叫
  179.      * @param duration 有效时长，单位：秒
  180.      * @return
  183.     public static String bindCall(String apikey, String from, String to,
  184.         Integer duration) {
  185.         Map < String, String > params = new HashMap < String, String > ();
  186.         params.put("apikey", apikey);
  187.         params.put("from", from);
  188.         params.put("to", to);
  189.         params.put("duration", String.valueOf(duration));
  190.         return post(URI_SEND_BIND, params);
  191.     }
  194.      * 通过接口解绑绑定主被叫号码
  195.      * @param apikey apikey
  196.      * @param from 主叫
  197.      * @param to   被叫
  198.      * @return
  200.     public static String unbindCall(String apikey, String from, String to) {
  201.         Map < String, String > params = new HashMap < String, String > ();
  202.         params.put("apikey", apikey);
  203.         params.put("from", from);
  204.         params.put("to", to);
  205.         return post(URI_SEND_UNBIND, params);
  206.     }
  207.      */
  209.     /**
  210.      * 基于HttpClient 4.3的通用POST方法
  211.      *
  212.      * @param url       提交的URL
  213.      * @param paramsMap 提交<参数，值>Map
  214.      * @return 提交响应
  215.      */
  217.     public static String post(String url, Map < String, String > paramsMap) {
  218.         CloseableHttpClient client = HttpClients.createDefault();
  219.         String responseText = "";
  220.         CloseableHttpResponse response = null;
  221.         try {
  222.             HttpPost method = new HttpPost(url);
  223.             if (paramsMap != null) {
  224.                 List < NameValuePair > paramList = new ArrayList <
  225.                     NameValuePair > ();
  226.                 for (Map.Entry < String, String > param: paramsMap.entrySet()) {
  227.                     NameValuePair pair = new BasicNameValuePair(param.getKey(),
  228.                         param.getValue());
  229.                     paramList.add(pair);
  230.                 }
  231.                 method.setEntity(new UrlEncodedFormEntity(paramList,
  232.                     ENCODING));
  233.             }
  234.             response = client.execute(method);
  235.             HttpEntity entity = response.getEntity();
  236.             if (entity != null) {
  237.                 responseText = EntityUtils.toString(entity, ENCODING);
  238.             }
  239.         } catch (Exception e) {
  240.             e.printStackTrace();
  241.         } finally {
  242.             try {
  243.                 response.close();
  244.             } catch (Exception e) {
  245.                 e.printStackTrace();
  246.             }
  247.         }
  248.         return responseText;
  249.     }
  250. }