• java DEMO

    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. }