狀態報告接口
1.1 請求地址
請求地址是客戶接口程序調用的時候請求的url地址,采用的是http post接口,地址是
http://101.201.116.58:8899/statusApi.aspx
入口地址一般不會發生變化,當發生變化的時候,會通知接口用戶
注意:相同的狀態報告,只能獲取一次。
1.2參數說明
參數名稱 |
含義 |
說明 |
userid |
企業id |
企業ID |
account |
用戶帳號 |
用戶帳號,由系統管理員 |
password |
帳號密碼 |
用戶賬號對應的密碼 |
statusNum |
每次取得號碼數 |
必須為數字,默認4000,可不填 |
action |
任務名稱 |
設置為固定的:query |
例如:
action=query&userid=12&account=賬號&password=密碼
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:參數不正確