批量发送超级短信
HTTP 头信息:
Accept:application/json;charset=utf-8; Content-Type:application/x-www-form-urlencoded;charset=utf-8;
请求
URL：https://vsms.yunpian.com/v2/vsms/tpl_batch_send.json 访问方式：POST
特别说明
- 超级短信功能需要联系客服开通后使用。
- 因运营商夜间防骚扰限制，建议您在早9:00至晚18:00间发送，超出此时间的发送可能会失败。
请求参数
参数名 | 类型 | 是否必传 | 是否默认开放 | 描述 | 示例 |
apikey | string | 是 | 是 | 用户唯一标识，在"账号设置"-"子帐号管理"中查看 | 9b11127a9701975c |
tpl_id | string | 是 | 是 | 模版 id | 126 |
mobile | string | 是 | 是 | 手机号,多个号码用英文逗号 分隔,限制 1000 个 | 单号码：15205201314 多号码：15205201314,15205201315 |
uid | string | 否 | 是 | 用户自定义的 uid，系统会在状态报告中返回此字段 | 9b11127a9701975c |
tpl_param_json | string | 否 | 是 | 短信模板变量对应的实际值，JSON格式。 如果JSON中需要带换行符，请参照标准的JSON协议处理；且模板变量值的个数必须与手机号码个数相同、内容一一对应，表示向指定手机号码中发对应变量内容的短信，且短信模板中的变量参数替换为对应的值。 | [{ "name":"姓名", "date:"今日"}, ...] |
callback_url | string | 否 | 否 | 短信发送后将向这个地址推送(运营商返回的)发送报告。 如推送地址固定，可以在“超级短信设置-数据推送设置”中添加。 如后台已设置地址，且请求内也包含此参数，将以请求内地址为准。 |
请求示例
php:
<?php
$ch = curl_init();
$apikey = "xxxxxxxxx"; //修改为您的apikey(https://www.yunpian.com)登录官网后获取
//你后台审核通过的模板id
$tpl_id = 123;
//单个号码
$mobile = "18800000000";
//多个号码
//$mobile = "18800001111,18800002222";
$ch = curl_init();
$data=array('apikey'=> $apikey,'tpl_id'=> $tpl_id,'mobile'=> $mobile);
curl_setopt($ch, CURLOPT_URL, 'https://vsms.yunpian.com/v2/vsms/tpl_batch_send.json');
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER,true);
$json_data = curl_exec($ch);
var_dump($json_data);
//解析返回结果（json格式字符串）
$array = json_decode($json_data,true);
print_r($array);响应
名称 | 类型 | 描述 |
total_count | integer | 总发送条数 |
total_fee | string | 扣费金额，单位：元 |
unit | string | 计费单位；例如：“RMB” |
data | json | json |
code | string | 0 代表请求成功 |
count | integer | 条数 |
fee | string | 计费 |
mobile | string | 手机号 |
msg | string | code 描述 |
sid | long（64位） | 唯一编码 |
transformSurlMap | json | 针对模板中有添加云片短链接，且开启了分手机号统计功能的，会返回短链接的主链和子链 |
Json 返回示例
{
"total_count": 1,
"total_fee": "0.3500",
"unit": "RMB",
"data": [
{
"msg": "模板不支持的运营商",
"code": 50,
"fee": 0.0,
"mobile": "13388889067",
"sid": 0
},
{
"msg": "",
"code": 0,
"transformSurlMap": {"45oDhX":"47wyS"},
"fee": 0.35,
"mobile": "15688888299",
"sid": 571400123754704896
}
]
}