批量发送超级短信


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间发送,超出此时间的发送可能会失败。
  1. 如需状态报告,请参考如下方式:
    获取状态报告
    推送状态报告


请求参数

参数名

类型

是否必传

是否默认开放

描述

示例

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位)

唯一编码


Json 返回示例


{
    "total_count": 1,
    "total_fee": "0.3500",
    "unit": "RMB",
    "data": [
        {
            "msg": "模板不支持的运营商",
            "code": 50,
            "fee": 0.0,
            "mobile": "13388889067",
            "sid": 0
        },
        {
            "msg": "",
            "code": 0,
            "fee": 0.35,
            "mobile": "15688888299",
            "sid": 571400123754704896
        }
    ]
}