批量发送超级短信


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


特别说明 该功能需联系在线客服开通。


说明


如需状态报告,请参考如下方式。



请求参数

参数名类型是否必传是否默认开放描述示例
apikeystring

用户唯一标识,在"账号设置"-"子帐号管理"中查看

9b11127a9701975c
734b8aee81ee3526
tpl_idstring模版 id126
mobilestring手机号,多个号码用英文逗号,分隔,限制 1000 个单号码:15205201314 多号码:15205201314,15205201315
uidstring

用户自定义的 uid,系统会在状态报告中返回此字段9b11127a9701975c
tpl_param_jsonstring短信模板变量对应的实际值,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_countinteger总发送条数
total_feestring扣费金额,单位:元,类型:双精度浮点型/double
unitstring计费单位;例如:“RMB”
datajsonjson
codestring0 代表请求成功
countinteger条数
feestring计费
mobilestring手机号
msgstringcode 描述
sidstring唯一编码


Json 返回示例


{
  "total_count": 28,
  "total_fee": "9.8000",
  "unit": "RMB",
  "data": [
    {
      "code": 0,
      "count": 1,
      "fee": 0.35,
      "mobile": "13101234567",
      "msg": "发送成功",
      "sid": 20573912666,
      "unit": "RMB"
    },
    {
      "code": 0,
      "count": 1,
      "fee": 0.35,
      "mobile": "130612345677",
      "msg": "发送成功",
      "sid": 20573912664,
      "unit": "RMB"
    }
  ]
}