发送短信

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

1.请求参数:

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(字典) 模板参数变量及变量值

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

您的验证码为:${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":{}
}

2. 请求示例代码(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);  
    } 

3. 返回结果如下:

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

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

文档更新时间: 2023-03-14 17:06   作者:admin