狀態(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ì)刪除,請(qǐng)妥善處理接口返回的數(shù)據(jù)。
備注:
該接口為高級(jí)接口,默認(rèn)不開放,如有需要請(qǐng)?jiān)诤笈_(tái)數(shù)據(jù)推送與獲取頁(yè)面設(shè)置開啟。
HTTP 頭信息:
Accept:application/json;charset=utf-8; Content-Type:application/x-www-form-urlencoded;charset=utf-8;
請(qǐng)求
URL:https://sms.yunpian.com/v2/voice/pull_status.json 注意:海外服務(wù)器地址 us.yunpian.com 訪問方式:POST
請(qǐng)求參數(shù)
參數(shù)名 | 類型 | 是否必須 | 描述 | 示例 |
apikey | string | 是 | 用戶唯一標(biāo)識(shí),在"賬號(hào)設(shè)置"-"子帳號(hào)管理"中查看 | 9b11127a9701975c734b8aee81ee3526 |
page_size | integer | 否 | 每頁(yè)個(gè)數(shù),最大 100 個(gè),默認(rèn) 20 個(gè) | 20 |
響應(yīng)
名稱 | 類型 | 描述 |
sid | string | 語音記錄 id,不超過 32 位的唯一字符串 |
uid | string | 用戶自定義 id |
user_receive_time | string | 用戶接收時(shí)間 |
duration | integer | 通話時(shí)長(zhǎng) |
error_msg | string | 接收失敗的原因,如:"Send Exception","用戶信號(hào)不佳、關(guān)機(jī)等" |
mobile | string | 接收手機(jī)號(hào) |
report_status | string | 接收狀態(tài)有:SUCCESS/FAIL,狀態(tài)值無需引號(hào) |
Json 響應(yīng)示例:
調(diào)用成功的返回值示例:
[ { "sid": "931ee0bac7494aab8a422fff5c6be3ea", "uid": null, "user_receive_time": "2015-07-01 14:29:12", "duration": 10, "error_msg": null, "mobile": "15205201314", "report_status": "SUCCESS" }, { "sid": "3375655611", "uid": null, "user_receive_time": "2015-07-01 14:30:09", "duration": 0, "error_msg": "failed", "mobile": "+37258483726", "report_status": "FAIL" } ]