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

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