獲取狀態(tài)報(bào)告
功能說明:
開通此接口功能后,我們將為您獨(dú)立再保存一份新生產(chǎn)的狀態(tài)報(bào)告數(shù)據(jù),保存時(shí)間為 72 小時(shí)。 您可以通過此接口獲取新產(chǎn)生的狀態(tài)報(bào)告。注意,已成功獲取的數(shù)據(jù)將會(huì)刪除,請妥善處理接口返回的數(shù)據(jù)。
備注:
- 該接口為高級接口,默認(rèn)不開放,可以在云片用戶后臺(tái)開啟。
- 建議使用單線程獲取。獲取數(shù)據(jù)后,建議根據(jù) sid 做去重。
HTTP 頭信息:
Accept:application/json;charset=utf-8;
Content-Type:application/x-www-form-urlencoded;charset=utf-8;
請求
URL:https://sms.yunpian.com/v2/sms/pull_status.json
注意:海外服務(wù)器地址 us.yunpian.com
訪問方式:POST
請求參數(shù)
接口說明
參數(shù)名 | 類型 | 是否必須 | 描述 | 示例 |
apikey | String | 是 | 用戶唯一標(biāo)識,在"賬號設(shè)置"-"子帳號管理"中查看 | 9b11127a9701975c734b8aee81ee3526 |
page_size | integer | 否 | 每頁個(gè)數(shù),最大 100 個(gè),默認(rèn) 20 個(gè) | 20 |
響應(yīng)參數(shù)
名稱 | 類型 | 描述 |
error_detail | string | 運(yùn)營商反饋代碼的中文解釋,僅供參考(默認(rèn)不推送此字段,如需推送,請聯(lián)系客服開通) |
sid | long(64 位) | 短信 id,64 位整型, 對應(yīng) Java 和 C#的 long,不可用 int 解析 |
uid | string | 用戶自定義 id |
user_receive_time | string | 用戶接收時(shí)間 |
error_msg | string | 運(yùn)營商返回的代碼,如:"DB:0103" |
mobile | string | 接收手機(jī)號 |
report_status | string | 接收狀態(tài)有:SUCCESS/FAIL |
###Json 響應(yīng)示例:
[
{
"error_detail": "接收成功",
"sid": 25116408942,
"uid": "123",
"user_receive_time": "2018-06-19 14:22:17",
"error_msg": "DELIVRD",
"mobile": "13735877801",
"report_status": "SUCCESS"
}
]