短信綜合信息管理系統(tǒng)

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