獲取狀態(tài)報告
功能說明:
開通此接口功能后,我們將為您獨立再保存一份新生產(chǎn)的狀態(tài)報告數(shù)據(jù),保存時間為72小時。 您可以通過此接口獲取新產(chǎn)生的狀態(tài)報告。注意,已成功獲取的數(shù)據(jù)將會刪除,請妥善處理接口返回的數(shù)據(jù)。
備注:
- 該接口為高級接口,默認(rèn)不開放,可以在云片用戶后臺開啟。
- 建議使用單線程獲取。獲取數(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 | 否 | 每頁個數(shù),最大100個,默認(rèn)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 | 接收手機(jī)號 |
report_status | string | 接收狀態(tài)有: "SUCCESS"/ "FAIL" |
重要說明
請按照如下順序使用參數(shù)
- 請先使用 report_status 判斷接收狀態(tài);如果是"SUCCESS",為接收成功;如果是"FAIL",為接收失?。?/span>
- 如果接收狀態(tài)失敗,可以參考error_detail 以及 error_msg 來獲取更詳細(xì)信息;特別注意,這兩個字段為解釋型字段,請不要依據(jù)這兩個字段判斷接收狀態(tài);
- 請妥善保存推送信息;
- 如果您的系統(tǒng)接收推送信息失敗,請及時聯(lián)系我們。
###Json響應(yīng)示例
[
{
"error_detail": "接收成功",
"sid": 9527,
"uid": "1234567",
"user_receive_time": "2014-03-17 22:55:21",
"error_msg": "DELIVRD",
"mobile": "15205201314",
"report_status": "SUCCESS"
},
{
"sid": 9528,
"user_receive_time": "2014-03-17 22:55:23",
"error_msg": "DELIVRD",
"mobile": "15212341234",
"report_status": "SUCCESS"
},
{
"error_detail": "接收成功",
"sid": 9529,
"uid": "abcdefg",
"user_receive_time": "2014-03-17 22:55:23",
"error_msg": "DELIVRD",
"mobile": "15212341234",
"report_status": "SUCCESS"
}
]