发送短信

可以单个或批量发送短信，三网合一，速度快，到达率高。 短信签名和模板请到蜂巢管理后台创建。 短信签名和模板创建后，请联系客服审核。

提示： 同一个蜂巢账户下的签名和模板可共用，即同一个模板可以给不同的签名使用。

一、请求参数

POST https://kf.fw199.com/gateway/sms/v2/send

参数名	类型	说明	示例
appid	String	合作伙伴AppId	uwkahf@jfs92
timestamp	String	当前时间戳
request_data	String	相关短信内容的json
sign	String	接口签名	如何计算生成见示例代码

request_data的详细说明

参数名	类型	说明
custom_sms_id	可填，String	客户自定义smsId
extended_code	可填，String	用户扩展码
mobiles	必填，String集合	手机号，多个手机请英文逗号隔开，最多一次发300个
templete_code	必填， string	模板代码，比如 **SMS_4037740358**
sign_name	必填， string	短信签名,比如 **蜂巢开放**，注意不用包含【】
template_param	必填，实为hashmap(字典)	模板参数变量及变量值
template_from	可选，owner：使用自己名下的签名和模板，common:使用通用的签名和模板（联系客服获取）, 不传默认为owner	owner

短信模板在蜂巢后台创建，如验证码模板如下：

您的验证码为：${code}，请勿泄露于他人，如不是本人操作，请忽略此信息。

上面的**${code}**为模板变量，模板变量在短信模板可以定义多个，变量名可自主定义。在接口调用时可传入实际值替换。

示例json如下

{
    "custom_sms_id":"",
    "extended_code":"",
    "mobiles":[
        "13816128913"
    ],
    "templete_code":"SMS_4037740358",
    "sign_name":"知神",
    "template_param":{
        "code":"3223"
    }
}

如果短信模板里没有模板变量，则template_param传{}，如下示例

{
    "custom_sms_id":"",
    "extended_code":"",
    "mobiles":[
        "13816128913"
    ],
    "templete_code":"SMS_6318499316",
    "sign_name":"知神",
    "template_param":{}
}

二、请求示例代码

Java

@Test
    public void sendSMSV2() throws Exception {
        String requestData = "{" +
                "                \"custom_sms_id\" :\"\", " +
                "                \"extended_code\" :\"\", " +
                "                \"mobiles\" : [\"138161272123\"], " +
                "                \"templete_code\" :  \"SMS_4037740358\", " +
                "                \"sign_name\" :\"蜂巢开放\", " +
                "                \"template_param\" :{\"code\":\"3223\"}" +
                "         }";

        Map<String, String> data = new HashMap<String, String>();
        data.put("appid",  Config.AppId);
        Long timestamp = System.currentTimeMillis() / 1000;
        data.put("timestamp", timestamp.toString());
        data.put("request_data",requestData );
        // 参数签名
        data.put("sign", Utils.Sign(data,Config.AppSecret));
        doHttpRequest(Config.SendSMSV2Url, data);
    }

三、返回结果

{"code":0,"message":"ok","data":"SUCCESS"}

说明： code为0表示成功，非0为失败，message会包含失败原因。 data为SUCCESS表示短信发送成功。