獲取狀態(tài)報告
功能說明:
開通此接口功能后,我們將為您獨立再保存一份新生產(chǎn)的狀態(tài)報告數(shù)據(jù),保存時間為 72 小時。 您可以通過此接口獲取新產(chǎn)生的狀態(tài)報告。注意,已成功獲取的數(shù)據(jù)將會刪除,請妥善處理接口返回的數(shù)據(jù)。
備注:
- 該接口為高級接口,默認不開放,可以在云片用戶后臺開啟。
- 建議使用單線程獲取。獲取數(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 | 是 | 用戶唯一標識,在"賬號設(shè)置"-"子帳號管理"中查看 | 9b11127a9701975c734b8aee81ee3526 |
page_size | integer | 否 | 每頁個數(shù),最大 100 個,默認 20 個 | 20 |
響應(yīng)參數(shù)
名稱 | 類型 | 描述 |
error_detail | string | 運營商反饋代碼的中文解釋,僅供參考(默認不推送此字段,如需推送,請聯(lián)系客服開通) |
sid | long(64 位) | 短信 id,64 位整型, 對應(yīng) Java 和 C#的 long,不可用 int 解析 |
uid | string | 用戶自定義 id |
user_receive_time | string | 用戶接收時間 |
error_msg | string | 運營商返回的代碼,如:"DB:0103" |
mobile | string | 接收手機號 |
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"
}
]