狀態(tài)報(bào)告推送接口
功能說(shuō)明:
開通此接口后,我們將為您實(shí)時(shí)推送最新的狀態(tài)報(bào)告。您需要提供一個(gè) url 地址,接受 http post 請(qǐng)求。 該接口一次最多推送 500 個(gè)狀態(tài)報(bào)告,為不影響推送速度,建議先接受數(shù)據(jù)后再做異步處理。
備注:
該接口為高級(jí)接口,需要自行在后臺(tái)設(shè)置開啟。
HTTP 頭信息:
Accept:application/json;charset=utf-8; Content-Type:application/x-www-form-urlencoded;charset=utf-8;
請(qǐng)求
URL:http://your_receive_url_address 訪問(wèn)方式:POST
請(qǐng)求參數(shù)
參數(shù)名 | 類型 | 是否必須 | 描述 |
voice_status | string | 是 | 經(jīng)過(guò) urlencode 編碼的數(shù)據(jù)形式如:voice_status=urlencode(json) |
具體詳解:
推送的數(shù)據(jù)格式:
參數(shù)名=經(jīng)過(guò)urlencode編碼的數(shù)據(jù)
形式如:
voice_status=urlencode(json)
服務(wù)端推送數(shù)據(jù)形式如下:
curl --data "voice_status=url_encode_json" http://your_receive_url_address
推送 json 參數(shù)
名稱 | 類型 | 描述 |
sid | string | 語(yǔ)音記錄 id,不超過(guò) 32 位的唯一字符串 |
uid | string | 用戶自定義 id |
user_receive_time | string | 用戶接收時(shí)間 |
error_msg | string | 接收失敗的原因,如:"Send Exception","用戶信號(hào)不佳、關(guān)機(jī)等" |
mobile | string | 接收手機(jī)號(hào) |
report_status | string | 接收狀態(tài)有:SUCCESS/FAIL,狀態(tài)值無(wú)需引號(hào) |
其中 json 示例為:
[ { "sid": "6e77feeab89f445387308db604e2ec8d", "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": "2020-07-01 14:33:23", "duration": 0, "error_msg": "failed", "mobile": "+37258483726", "report_status": "FAIL" } ]
備注:
接收到數(shù)據(jù)后,請(qǐng)從參數(shù) voice_status 中取值,取到值使用 urldecode 解碼后為實(shí)際 json 格式數(shù)據(jù)(部分語(yǔ)言由于解碼方式差異需要解碼兩次) 處理成功請(qǐng)返回字符串"SUCCESS"或"0",其他返回值將被認(rèn)為是失敗。
該接口失敗重試次數(shù)為 3 次,每次間隔 5 分鐘。