狀態報告接口
1.1 請求地址
請求地址是客戶接口程序調用的時候請求的url地址,采用的是http post接口,地址是
http://47.92.121.147/statusApi.aspx
http://47.92.121.147/statusJsonApi.aspx(返回值為json格式)
入口地址一般不會發生變化,當發生變化的時候,會通知接口用戶
1.2參數說明
參數名稱 |
含義 |
說明 |
userid |
企業id |
企業ID |
account |
用戶帳號 |
用戶帳號,由系統管理員 |
password |
帳號密碼 |
用md5加密方式,md5彩用32位大寫 如abc123加密后為 E99A18C428CB38D5F260853678922E03
|
statusNum |
每次取得號碼數 |
必須為數字,默認4000,可不填 |
action |
任務名稱 |
設置為固定的:query |
taskid |
批次編號 |
可選項,如果傳此參數,則只查詢該批次的狀態。 |
例如:
action=query&userid=12&account=賬號&password=密碼& taskid =1523516
1.3返回值
<?xml version="1.0" encoding="utf-8" ?>
<returnsms>
<statusbox>
<mobile>15023239810</mobile>-------------對應的手機號碼
<taskid>1212</taskid>-------------同一批任務ID
<status>10</status>---------狀態報告----10:發送成功,20:發送失敗
<receivetime>2011-12-02 22:12:11</receivetime>-------------接收時間
<errorcode>DELIVRD</errorcode>-上級網關返回值,不同網關返回值不同,僅作為參考
<extno>01</extno>--子號,即自定義擴展號
</statusbox>
<statusbox>
<mobile>15023239811</mobile>
<taskid>1212</taskid>
<status>20</status>
<receivetime>2011-12-02 22:12:11</receivetime>
<errorcode>2</errorcode>
<extno></extno>
</statusbox>
</returnsms>
1.4錯誤返回值——狀態報告請求錯誤返回格式及對應值
<?xml version="1.0" encoding="utf-8" ?>
<returnsms>
<errorstatus>
<error>1</error>-------------錯誤碼
<remark>用戶名或密碼不能為空</remark>-------------錯誤描述
</errorstatus>
</returnsms>
1:用戶名或密碼不能為空
2:用戶名或密碼錯誤
3:該用戶不允許查看狀態報告
4:參數不正確
1.5Json返回值
錯誤時:{"error":"1005","remark":"密碼錯了","statusbox":[]}
正確時:{"error":"1",
"remark":"成功",
"statusbox":[
{"mobile":"15510331875",
"taskid":"123",
"receivetime":"2015-01-01 00:00:00",
"errorcode":"dEv"
},{
"mobile":"13483728958",
"taskid":"124",
"receivetime":"2015-02-01 00:00:00",
"errorcode":"back"}
]
}