短信发送api示例

首先说一下短信验证的使用场景。
       1、与账户信息相关的操作，如修改支付宝账号等
       2、与资金流转相关的操作，如提现等
       只有在以上两种场景下，短信验证才会起到作用。即提交相关操作的时候，附带一个验证码。
       在本项目中，使用的短信平台是云片网。本文会举一个例子来演示短信：

流程

1、云片网上的短信是通过一个http请求触发的。

    // 通用发送接口的http地址
    private static String URI_SEND_SMS = "http://yunpian.com/v1/sms/send.json";

    //模板发送接口的http地址
    private static String URI_TPL_SEND_SMS = "https://sms.yunpian.com/v1/sms/tpl_send.json";

    //发送语音验证码接口的http地址
    private static String URI_SEND_VOICE = "https://voice.yunpian.com/v1/voice/send.json";

     /**
     * 基于HttpClient 4.3的通用POST方法
     *
     * @param url
     *            提交的URL
     * @param paramsMap
     *            提交<参数，值>Map
     * @return 提交响应
     */
    public static String post(String url, Map<String, String> paramsMap) {
        StringBuilder str=new StringBuilder("调用发送短信外部接口：post-->");
        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);
            }
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            try {
                response.close();
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
        str.append("responseText:").append(responseText).append("_");
        System.out.println("responseText:"+responseText);
        return responseText;
    }

1、在云片网上注册一个帐号，购买相应的服务。
2、设置发送短信的模版
       模版的组成部分：【签名】+短信正文
       先要申请签名。签名通过之后，在使用该签名添加模版。
       格式如：【XXX】亲爱的用户，您的注册码是#code#。如非本人操作，请忽略此短信。
3、三种不同的方式
       1）发送模版的时候，可以以text文本发送，即发送的时候text与模版进行匹配

    /**
     * 使用模版匹配方式发短信
     *
     * @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);
    }

       2）另一种方式是，直接指定模版id进行发送

    /**
     * 指定模版发短信
     *
     * @param apikey    apikey（来自云片网的账户信息）
     * @param tpl_id   模版id
     * @param tpl_value  模版中的通配符
     * @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("tpl_id", "994567"); //模版id
        params.put("tpl_value", "#code#=1234");
        params.put("mobile", mobile);
        return post(URI_TPL_SEND_SMS, params);
    }

       3)使用语音播报的方式

    /**
     * 使用语音播报的方式
     *
     * @param apikey    apikey（来自云片网的账户信息）
     * @param code  验证码
     * @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("mobile", mobile);
        params.put("code", "456789");
        return post(URI_SEND_VOICE, params);
    }

调用发送短信：

    public static void main(String[] args) throws IOException {
        String apikey = "云片网上的apikey"
        String text = "【签名】您的验证码是";
        String code = "";

        Random random = new Random();
        for (int i = 0; i < 6; i++) {
            code += random.nextInt(10);
        }
        text = text + code;
        sendSms(apikey, text, "187XXXX5771");//手机号
        System.out.println("code:" + code);
    }

       短信发送，算是一块成熟的技术。所以肯定有第三方程序已经提供了。我们需要做的就是找到这些程序，把他们提供的使用到我们的项目中。