批量发送超级短信

HTTP 头信息: 

  1. Accept:application/json;charset=utf-8;
  2. Content-Type:application/x-www-form-urlencoded;charset=utf-8;

请求

  1. URL：https://vsms.yunpian.com/v2/vsms/tpl_batch_send.json
  2. 访问方式：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
        }
    ]
}