資源描述:
《短信平臺(tái)api接口使用手冊(cè)》由會(huì)員上傳分享,免費(fèi)在線閱讀,更多相關(guān)內(nèi)容在應(yīng)用文檔-天天文庫(kù)。
1、南京市建鄴區(qū)短信平臺(tái)API接口說明目錄1API接口31.1接口函數(shù)說明31.1.1單條發(fā)送消息函數(shù)ExecSendMessage31.1.2群發(fā)短消息的函數(shù)ExecSendBatchMessage41.2企業(yè)接口調(diào)用方式51.2.1C#中的調(diào)用51.2.2Javascript的調(diào)用51.2.3Java的調(diào)用方式61API接口API接口的實(shí)現(xiàn)使用了WebService的方式,用戶通過調(diào)用WebService的指定接口函數(shù)以達(dá)到發(fā)送短信的目的;企業(yè)接口的服務(wù)頁(yè)面為Webservice/SendShortMessage.asmx,如果WEB服務(wù)器地址為:http://192.168.200.17
2、:90那么訪問WebService的地址就為:http://192.168.200.17:90/Webservice/SendShortMessage.asmx要查看接口的定義的話則在連接地址下面增加“?WSDL”,即:http://192.168.200.17:90/Webservice/SendShortMessage.asmx?WSDL1.1接口函數(shù)說明企業(yè)接口中提供了三個(gè)函數(shù),如下:StringExecSendMessage(stringmessageContent,stringsender,stringreceivers,stringsingn)XmlDocumentExecSe
3、ndBatchMessage(stringmessageContent,stringsender,stringreceivers,stringsingn)XmlDocmentLoadReceiveMessage(stringsendPhoneNum,stringstartTime,stringendTime)ExecSendMessage函數(shù)為單條發(fā)送短消息的函數(shù)ExecSendBatchMessage函數(shù)為群發(fā)短消息的函數(shù)(不建議使用)LoadReceiveMessage函數(shù)為接收指定號(hào)碼回復(fù)的短信記錄的函數(shù)1.1.1單條發(fā)送消息函數(shù)ExecSendMessage函數(shù)定義如下:Strin
4、gExecSendMessage(stringmessageContent,stringsender,stringreceivers,stringsingn)函數(shù)參數(shù)有四個(gè):參數(shù)名說明messageContent要發(fā)送的短信內(nèi)容(最長(zhǎng)支持220個(gè)漢字)sender短信發(fā)送人(如計(jì)生系統(tǒng)或者是有意義的能夠表示發(fā)送人信息的內(nèi)容最長(zhǎng)15個(gè)漢字)receivers短信接收號(hào)碼(小靈通要加上區(qū)號(hào))singn短信簽名(最長(zhǎng)25個(gè)漢字如計(jì)生平臺(tái))返回參數(shù)為字符串類型:發(fā)送成功返回“成功”,否則返回錯(cuò)誤原因。1.1.1群發(fā)短消息的函數(shù)ExecSendBatchMessage函數(shù)定義如下:XmlDocume
5、ntExecSendBatchMessage(stringmessageContent,stringsender,stringreceivers,stringsingn)函數(shù)參數(shù)有四個(gè):參數(shù)名說明messageContent要發(fā)送的短信內(nèi)容(最長(zhǎng)支持220個(gè)漢字)sender短信發(fā)送人(如計(jì)生系統(tǒng)或者是有意義的能夠表示發(fā)送人信息的內(nèi)容最長(zhǎng)15個(gè)漢字)receivers短信接收號(hào)碼(小靈通要加上區(qū)號(hào),多個(gè)號(hào)碼用半角分號(hào)“;”間隔)singn短信簽名(最長(zhǎng)25個(gè)漢字如計(jì)生平臺(tái))說明:為防止方法調(diào)用超時(shí),短信接收號(hào)碼不要大于50個(gè)。返回參數(shù)為一個(gè)XML文檔,XML文檔的格式如下:群發(fā)前,條件驗(yàn)證
6、失敗群發(fā)中,出現(xiàn)錯(cuò)誤群發(fā)成功,返回結(jié)果屬性說明:Result節(jié)點(diǎn),表示執(zhí)行結(jié)果。其中:id:可以有三個(gè)值:0,1和2,如果為
7、0表示驗(yàn)證失敗,如果為1則表示執(zhí)行成功,如果為2表示部分號(hào)碼發(fā)送失敗value:此屬性表示執(zhí)行結(jié)果的文字描述mess:在id為0的時(shí)候,此屬性顯示驗(yàn)證失敗的原因Failed節(jié)點(diǎn),表示群發(fā)時(shí)出現(xiàn)發(fā)送失敗。其中:total:此屬性表示發(fā)送失敗的號(hào)碼總數(shù)Tel:此節(jié)點(diǎn)表示具體失敗的號(hào)碼信息,屬性number表示短信接收號(hào)碼,屬性mess表示失敗原因1.1.1接收指定號(hào)碼回復(fù)的短信記錄LoadReceiveMessage函數(shù)定義