发送短信
可以单个或批量发送短信,三网合一,速度快,到达率高。 短信签名和模板请到蜂巢管理后台创建。
短信签名和模板创建后,请联系客服审核。
提示: 同一个蜂巢账户下的签名和模板可共用,即同一个模板可以给不同的签名使用。
1.请求参数:
参数名 | 类型 | 说明 | 示例 |
---|---|---|---|
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表示短信发送成功。
文档更新时间: 2024-11-18 18:50 作者:admin