推送狀態(tài)報告


功能說明:開通此接口后,我們將為您實時推送最新的狀態(tài)報告。您需要提供一個callback url地址,接受http post請求。 該接口一次最多推送100個狀態(tài)報告,為不影響推送速度,建議先接受數(shù)據(jù)后再做異步處理。


備注:


  • 本功能默認不開啟,如需開啟請前往“系統(tǒng)設(shè)置-數(shù)據(jù)獲取與推送”頁設(shè)置。您可以設(shè)置固定的callback url 地址,也可以在每次發(fā)送請求中攜帶callback url 地址。我們會優(yōu)先向發(fā)送請求中攜帶的callback url 地址推送。
  • 所有帶+86前綴的號碼都會去掉+86
  • 接收到數(shù)據(jù)后,請從參數(shù)sms_status中取值,取到值使用urldecode解碼后為實際json格式數(shù)據(jù)(部分語言由于解碼方式差異需要解碼兩次)處理成功請返回字符串"SUCCESS"或"0",其他返回值將被認為是失敗。該接口失敗重試次數(shù)為3次,每次間隔5分鐘。
  • 獲取數(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


注意:海外服務(wù)器地址 us.yunpian.com


訪問方式: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“


重要說明


請按照如下順序使用參數(shù)


  1. 請先使用 report_status 判斷接收狀態(tài);如果是"SUCCESS",為接收成功;如果是"FAIL",為接收失??;
  1. 如果接收狀態(tài)失敗,可以參考error_detail 以及 error_msg 來獲取更詳細信息;特別注意,這兩個字段為解釋型字段,請不要依據(jù)這兩個字段判斷接收狀態(tài);
  1. 請妥善保存推送信息;
  1. 如果您的系統(tǒng)接收推送信息失敗,請及時聯(lián)系我們。


其中json示例


[
    {
        "error_detail": "接收成功",
        "sid": 9527,
        "uid": "1234567",
        "user_receive_time": "2014-03-17 22:55:21",
        "error_msg": "DELIVRD",
        "mobile": "15205201314",
        "report_status": "SUCCESS"
    },
    {   "error_detail": "空號、停機或關(guān)機",
        "sid": 9528,
        "uid": "121",
        "user_receive_time": "2014-03-17 22:55:23",
        "error_msg": "MI:0024",
        "mobile": "15212341235",
        "report_status": "FAIL"
    },
    {
        "error_detail": "接收成功",
        "sid": 9529,
        "uid": "abcdefg",
        "user_receive_time": "2014-03-17 22:55:23",
        "error_msg": "DELIVRD",
        "mobile": "15212341234",
        "report_status": "SUCCESS"
    }
]
特黄人与动人物视频A级毛片,久久婷婷五月色综合蜜芽,亚洲AV永久无码区成人网站,精品无码成人网站久久久久久无码 ,日本动漫爆乳H动漫啪啪免费,成年女人毛片免费视频喷潮,一本之道高清在线观看免费,一级A片无遮挡,18禁美女挤奶水视频免费,欧美牲交A欧美牲交AⅤ电影