云片：批量发送超级短信示例

批量发送超级短信

 

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

 

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

 

说明

 

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

 

• 获取状态报告

• 推送状态报告

 

请求参数

参数名	类型	是否必传	是否默认开放	描述	示例
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:

 

 $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	扣费金额，单位：元，类型：双精度浮点型/double
unit	string	计费单位；例如：“RMB”
data	json	json
code	string	0 代表请求成功
count	integer	条数
fee	string	计费
mobile	string	手机号
msg	string	code 描述
sid	string	唯一编码

 

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