短信上行接口
1.1 請求地址
請求地址是客戶接口程序調用的時候請求的url地址,采用的是http post接口,地址是
http://47.92.121.147/callApi.aspx
http://47.92.121.147/callJsonApi.aspx(返回值為json格式)
入口地址一般不會發生變化,當發生變化的時候,會通知接口用戶
1.2參數說明
參數名稱 |
含義 |
說明 |
userid |
企業id |
企業ID |
account |
用戶帳號 |
用戶帳號,由系統管理員 |
password |
帳號密碼 |
用md5加密方式,md5彩用32位大寫 如abc123加密后為 E99A18C428CB38D5F260853678922E03
|
action |
任務名稱 |
設置為固定的:query |
例如:
action=query&userid=12&account=賬號&password=密碼
1.3返回值
<?xml version="1.0" encoding="utf-8" ?>
<returnsms>
<callbox>
<mobile>15023239810</mobile>-------------對應的手機號碼
<taskid>1212</taskid>-------------同一批任務ID
<content>你好,我不需要</content>---------上行內容
<receivetime>2011-12-02 22:12:11</receivetime>-------------接收時間
<extno>01</extno>----子號,即自定義擴展號
</callbox>
<callbox>
<mobile>15023239811</mobile>
<taskid>1212</taskid>
<content>你好,本次活動路線是怎么的</content>
<receivetime>2011-12-02 22:12:11</receivetime>
<extno>01</extno>
</callbox>
</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":"密碼錯了","callbox":[]}
正確時:{"error":"1",
"remark":"成功",
"callbox":[
{"mobile":"15510331875",
"taskid":"",
"content":"a",
"receivetime":"0001-01-01 00:00:00",
"extno":"123"
},{
"mobile":"13483728958",
"taskid":"",
"content":"b",
"receivetime":"0001-01-01 00:00:00",
"extno":"456"
}
]
}