http:// 服務(wù)器地址:端口/service/webService/Web_Service?wsdl
- 接口參數(shù):
- 服務(wù)器地址:IP
- 端口:PORT
- 用戶賬號(hào):
- 用戶密碼:
- 通信認(rèn)證密碼:
第一章 余額
1.1 請(qǐng)求地址
String getAmount(String xmlParams)
xmlParams:字符串類型,以xml格式的請(qǐng)求參數(shù),詳細(xì)請(qǐng)求格式看以下具體參數(shù)說明。
1.2參數(shù)說明
testss 123456 453245
參數(shù)名稱 | 含義 | 說明 |
username | 用戶賬號(hào) | 用戶賬號(hào) |
password | 用戶密碼 | 用戶密碼 |
veryCode | 通信認(rèn)證密碼 |
1.3返回值
在接收請(qǐng)求后,返回以xml的方式返回處理結(jié)果。格式為:
返回值說明:0 -------返回狀態(tài)值:成功返回0 失敗返回:失敗代碼------當(dāng)status為0時(shí),會(huì)出現(xiàn)該屬性
名稱 | 說明 |
status | 返回狀態(tài)值,具體參照狀態(tài)碼說明 |
account | 余額,條數(shù)= acount * 10 |
返回碼 | 描 述 |
0 | 查詢成功 |
100 | 查詢余額失敗 |
101 | 用戶賬號(hào)不存在或密碼錯(cuò)誤 |
102 | 賬號(hào)已禁用 |
103 | 參數(shù)不正確 |
105 | 認(rèn)證碼錯(cuò)誤 |
117 | 未開通此接入方式 |
數(shù)字account | 短信余額 |
第二章 發(fā)送接口
2.1 請(qǐng)求地址
String sendMsg(String xmlParams)
xmlParams:字符串類型,以xml格式的請(qǐng)求參數(shù),詳細(xì)請(qǐng)求格式看以下具體參數(shù)說明。
2.2參數(shù)說明
JSM00001 123456 453245 1595****097 @1@=你好 8888 2 1 JSM00001-0001
參數(shù)名稱
|
含義
|
說明
|
username
|
用戶賬號(hào)(必填)
|
用戶賬號(hào)
|
password
|
用戶密碼(必填)
|
用戶密碼
|
veryCode
|
通信認(rèn)證密碼(必填) | 通信認(rèn)證密碼。 |
mobile | 手機(jī)號(hào)碼(必填) | 手機(jī)號(hào)碼(群發(fā)短信時(shí),最多100個(gè),英文逗號(hào),隔開) |
content | 短信內(nèi)容(必填) | 短信內(nèi)容(最多300個(gè)漢字),特殊字符需要轉(zhuǎn)義;如果使用模板短信發(fā)送,此參數(shù)用來傳遞模板短信的變量和值,參數(shù)之間以逗號(hào)隔開 |
extcode | 擴(kuò)展碼 | 用戶自己分配的小號(hào)(即顯示在接收手機(jī)上的主叫尾號(hào),可用于上行信息匹配)例:我們給合作方開的特服號(hào)是106905994140010,然后合作方在發(fā)送信息的時(shí)候可以隨意填寫擴(kuò)展號(hào)ext=8888(最大支持4位),那么用戶收到信息時(shí)顯示的下發(fā)號(hào)碼就是1069059941400108888 |
sendtime | 定時(shí)時(shí)間 | 定時(shí)短信的定時(shí)時(shí)間,格式為: (yyyyMMddhhmmss),例如:20140504111010 代表2014年5月4日 11時(shí)10分10秒,短信會(huì)在指定的時(shí)間發(fā)送出去 sendTime值為空時(shí),為即時(shí)發(fā)送短信 sendTime值不為空時(shí),為定時(shí)發(fā)送短信 |
msgtype |
短信類型(必填) |
短信類型。1-普通短信,2-模板短信。 |
signtag |
短信簽名序號(hào) |
短信簽名序號(hào),如果帳號(hào)報(bào)備多個(gè)簽名,此參數(shù)指定使用第幾個(gè)簽名(由于運(yùn)營商要求,帳號(hào)只允許單一簽名,此參數(shù)可以省略) |
signtext |
自定義簽名 |
自定義簽名,帳號(hào)支持自定義簽名該參數(shù)才生效 |
tempid |
模板短信編號(hào) |
模板編號(hào),(msgtype=2時(shí)參數(shù)必填) |
code | 編碼格式 | 編碼方式(utf-8,gbk),默認(rèn):gbk |
1) IP:如果用戶開賬戶時(shí)指定IP,則接口只接收該IP發(fā)送請(qǐng)求。
2) 發(fā)送模版短信msgtype=2,tempid必須填寫模版編號(hào)
2.3 返回值
返回值說明
名稱 | 說明 |
status | 返回狀態(tài)值,具體參照狀態(tài)碼說明 |
msgid | 消息id,和狀態(tài)報(bào)告內(nèi)msgid匹配的 |
返回碼 | 描 述 |
0 | 提交成功 |
100 | 發(fā)送失敗 |
101 | 用戶賬號(hào)不存在或密碼錯(cuò)誤 |
102 | 賬號(hào)已禁用 |
103 | 參數(shù)不正確 |
105 | 短信內(nèi)容超過300字或?yàn)榭?、或?nèi)容編碼格式不正確 |
106 | 手機(jī)號(hào)碼超過100個(gè)或有錯(cuò)誤號(hào)碼 |
108 | 余額不足 |
109 | ip錯(cuò)誤 |
110#(敏感詞A,敏感詞B) | 短信內(nèi)容存在系統(tǒng)保留關(guān)鍵詞,如有多個(gè)詞,使用逗號(hào)分隔:110#(李老師,XX,成人) |
114 | 模板短信序號(hào)不存在 |
115 | 短信簽名標(biāo)簽序號(hào)不存在 |
116 | 認(rèn)證碼不正確 |
117 | 未開通此接入方式 |
第三章 狀態(tài)報(bào)告接口
3.1 請(qǐng)求地址
String queryReport(String xmlParams)
xmlParams:字符串類型,以xml格式的請(qǐng)求參數(shù),詳細(xì)請(qǐng)求格式看以下具體參數(shù)說明。
建議訪問頻率:3分鐘一次
3.2參數(shù)說明
JSM00001 123456 453245
參數(shù)名稱 | 含義 | 說明 |
username | 用戶賬號(hào)(必填) | 用戶賬號(hào) |
password | 用戶密碼(必填) | 用戶密碼 |
veryCode | 通信認(rèn)證密碼(必填) |
3.3返回值
返回值說明:1595****097 7506751276725633025 MA:0006 1595****097 7506751276725633026 MA:0006 1595****097 7507418680283693057 DELIVRD
名稱 | 說明 |
mobile | 返回狀態(tài)值,具體參照狀態(tài)碼說明 |
msgid | 消息id,與發(fā)送接口消息id對(duì)應(yīng) |
status | 返回狀態(tài)碼,具體參照狀態(tài)碼說明 |
time | 狀態(tài)報(bào)告的時(shí)間 |
extno | 擴(kuò)展碼 |
返回碼 | 描 述 |
DELIVRD | 發(fā)送成功,返回其他請(qǐng)參照失敗狀態(tài)碼 |
3.4錯(cuò)誤返回值
返回值說明:
名稱 | 說明 |
status | 返回狀態(tài)碼,具體參照狀態(tài)碼說明 |
返回碼 | 描 述 |
100 | 獲取狀態(tài)報(bào)告失敗 |
101 | 用戶賬號(hào)不存在或密碼錯(cuò)誤 |
102 | 賬號(hào)已禁用 |
103 | 參數(shù)不正確 |
104 | 暫無短信狀態(tài)報(bào)告 |
105 | 認(rèn)證碼錯(cuò)誤 |
117 | 未開通此接入方式 |
第四章 上行接口
4.1 請(qǐng)求地址
String queryMo(String xmlParams)
xmlParams:字符串類型,以xml格式的請(qǐng)求參數(shù),詳細(xì)請(qǐng)求格式看以下具體參數(shù)說明。
建議訪問頻率:3分鐘一次
4.2 參數(shù)說明
JSM00001 123456 453245
參數(shù)名稱 | 含義 | 說明 |
username | 用戶賬號(hào)(必填) | 用戶賬號(hào) |
password | 用戶密碼(必填) | 用戶密碼 |
veryCode | 通信認(rèn)證密碼(必填) |
4.3返回值
返回值說明:1595****097 106905994140001 江蘇美圣信息技術(shù)有限公司 1595****097 106905994140001 4006000699
名稱 | 說明 |
mobile | 對(duì)應(yīng)的手機(jī)號(hào)碼 |
recvcode | 接受號(hào)碼 |
content | 回復(fù)內(nèi)容 |
time | 接收時(shí)間 |
4.4錯(cuò)誤返回值
返回值說明:
名稱 | 說明 |
status | 返回狀態(tài)碼,請(qǐng)參照狀態(tài)碼說明 |
返回碼 | 描 述 |
100 | 獲取上行短信失敗 |
101 | 用戶賬號(hào)不存在或密碼錯(cuò)誤 |
102 | 賬號(hào)已禁用 |
103 | 參數(shù)不正確 |
104 | 暫無上行短信 |
105 | 認(rèn)證碼錯(cuò)誤 |
117 | 未開通此接入方式 |