Question

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

特别说明

1. 超级短信功能需要联系客服开通后使用。
2. 因运营商夜间防骚扰限制，建议您在早9:00至晚18:00间发送，超出此时间的发送可能会失败。

3. 如需状态报告，请参考如下方式：
   获取状态报告
   推送状态报告

请求参数

参数名	类型	是否必传	是否默认开放	描述	示例
apikey	string	是	是	用户唯一标识，在"账号设置"-"子帐号管理"中查看	9b11127a9701975c 734b8aee81ee3526
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	否	否	短信发送后将向这个地址推送(运营商返回的)发送报告。 如推送地址固定，可以在“超级短信设置-数据推送设置”中添加。 如后台已设置地址，且请求内也包含此参数，将以请求内地址为准。	http://your_receive_url_address

请求示例

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
        }
    ]
}