批量發(fā)送超級短信
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
特別說明
- 超級短信功能需要聯(lián)系客服開通后使用。
- 因運(yùn)營商夜間防騷擾限制,建議您在早9:00至晚18:00間發(fā)送,超出此時間的發(fā)送可能會失敗。
- 如需狀態(tài)報告,請參考如下方式:
獲取狀態(tài)報告
推送狀態(tài)報告
請求參數(shù)
參數(shù)名 | 類型 | 是否必傳 | 是否默認(rèn)開放 | 描述 | 示例 |
apikey | string | 是 | 是 | 用戶唯一標(biāo)識,在"賬號設(shè)置"-"子帳號管理"中查看 | 9b11127a9701975c |
tpl_id | string | 是 | 是 | 模版 id | 126 |
mobile | string | 是 | 是 | 手機(jī)號,多個號碼用英文逗號 分隔,限制 1000 個 | 單號碼:15205201314 多號碼:15205201314,15205201315 |
uid | string | 否 | 是 | 用戶自定義的 uid,系統(tǒng)會在狀態(tài)報告中返回此字段 | 9b11127a9701975c |
tpl_param_json | string | 否 | 是 | 短信模板變量對應(yīng)的實(shí)際值,JSON格式。 如果JSON中需要帶換行符,請參照標(biāo)準(zhǔn)的JSON協(xié)議處理;且模板變量值的個數(shù)必須與手機(jī)號碼個數(shù)相同、內(nèi)容一一對應(yīng),表示向指定手機(jī)號碼中發(fā)對應(yīng)變量內(nèi)容的短信,且短信模板中的變量參數(shù)替換為對應(yīng)的值。 | [{ "name":"姓名", "date:"今日"}, ...] |
callback_url | string | 否 | 否 | 短信發(fā)送后將向這個地址推送(運(yùn)營商返回的)發(fā)送報告。 如推送地址固定,可以在“超級短信設(shè)置-數(shù)據(jù)推送設(shè)置”中添加。 如后臺已設(shè)置地址,且請求內(nèi)也包含此參數(shù),將以請求內(nèi)地址為準(zhǔn)。 |
請求示例
php:
<?php $ch = curl_init(); $apikey = "xxxxxxxxx"; //修改為您的apikey(http://www.ssjdyy2.com)登錄官網(wǎng)后獲取 //你后臺審核通過的模板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); //解析返回結(jié)果(json格式字符串) $array = json_decode($json_data,true); print_r($array);
響應(yīng)
名稱 | 類型 | 描述 |
total_count | integer | 總發(fā)送條數(shù) |
total_fee | string | 扣費(fèi)金額,單位:元 |
unit | string | 計費(fèi)單位;例如:“RMB” |
data | json | json |
code | string | 0 代表請求成功 |
count | integer | 條數(shù) |
fee | string | 計費(fèi) |
mobile | string | 手機(jī)號 |
msg | string | code 描述 |
sid | long(64位) | 唯一編碼 |
transformSurlMap | json | 針對模板中有添加云片短鏈接,且開啟了分手機(jī)號統(tǒng)計功能的,會返回短鏈接的主鏈和子鏈 |
Json 返回示例
{ "total_count": 1, "total_fee": "0.3500", "unit": "RMB", "data": [ { "msg": "模板不支持的運(yùn)營商", "code": 50, "fee": 0.0, "mobile": "13388889067", "sid": 0 }, { "msg": "", "code": 0, "transformSurlMap": {"45oDhX":"47wyS"}, "fee": 0.35, "mobile": "15688888299", "sid": 571400123754704896 } ] }