推送狀態(tài)報告
功能說明:
開通此接口后,我們將為您實時推送最新的狀態(tài)報告。您需要提供一個 url 地址,接受 http post 請求。 該接口一次最多推送 100 個狀態(tài)報告,為不影響推送速度,建議先接受數(shù)據(jù)后再做異步處理。
備注:
- 本功能默認不開啟,如果開啟請前往數(shù)據(jù)獲取與推送頁設(shè)置。
- 獲取數(shù)據(jù)后,建議根據(jù) sid 做去重。
HTTP 頭信息:
Accept:application/json;charset=utf-8;
Content-Type:application/x-www-form-urlencoded;charset=utf-8;
請求
URL:http://your_receive_url_address
訪問方式:POST
請求參數(shù)
參數(shù)名 | 類型 | 是否必須 | 描述 |
sms_status | string | 是 | 經(jīng)過 urlencode 編碼的數(shù)據(jù)形式如:sms_status=urlencode(json) |
具體詳解:
推送的數(shù)據(jù)格式:
參數(shù)名=經(jīng)過urlencode編碼的數(shù)據(jù)
形式如:
sms_status=urlencode(json)
服務(wù)端推送數(shù)據(jù)形式如下:
curl --data "sms_status=url_encode_json" http://your_receive_url_address
推送 json 參數(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 示例為:
[
{
"error_detail": "接收成功",
"sid": 9527,
"uid": null,
"user_receive_time": "2014-03-17 22:55:21",
"error_msg": "",
"mobile": "+93701234567",
"report_status": "SUCCESS"
},
{
"error_detail": "錯誤號碼,不扣費",
"sid": 9528,
"uid": null,
"user_receive_time": "2014-03-17 22:55:23",
"error_msg": "YP:54",
"mobile": "+93701234566",
"report_status": "FAIL"
}
]
備注:
接收到數(shù)據(jù)后,請從參數(shù) sms_status 中取值,取到值使用 urldecode 解碼后為實際 json 格式數(shù)據(jù)(部分語言由于解碼方式差異需要解碼兩次)。
處理成功請返回字符串"SUCCESS"或"0",其他返回值將被認為是失敗。該接口失敗重試次數(shù)為 3 次,每次間隔 5 分鐘。