新平臺(tái)-領(lǐng)先互聯(lián)短信接口文檔-最近版1016

1、領(lǐng)先互聯(lián)接口文檔短信平臺(tái)接口說明v1.0目錄一、短信下行接口31.接口地址32.調(diào)用參數(shù)說明33.返回格式44.返回參數(shù)說明45.調(diào)用URL示例56.發(fā)送長短信5二、上行與狀態(tài)報(bào)告51.接口命名62.上行、狀態(tài)報(bào)告參數(shù)63.上行示例74.狀態(tài)報(bào)告示例7三、余額查詢接口71.接口地址72.調(diào)用參數(shù)說明83.返回格式84.85.調(diào)用URL示例8一、 短信下行接口1. 接口地址8:8082/SendMT/SendMessage提交方式：POST編碼：UTF-82. 調(diào)用參數(shù)說明參數(shù)名是否可選類型說明CorpID必選string帳號(hào)名稱Pwd必選string密碼Ce

2、ll選填string通道號(hào)碼末尾添加的擴(kuò)展號(hào)碼Mobile必選string多個(gè)手機(jī)號(hào)碼之間用英文“,”分開，最大支持1000個(gè)手機(jī)號(hào)碼，同一請(qǐng)求中，最好不要出現(xiàn)相同的手機(jī)號(hào)碼Content必選string短信內(nèi)容，內(nèi)容需要URL(UTF-8)編碼例如： URLEncoder.encode(Content, " UTF-8");3. 返回格式參數(shù)名示例說明成功響應(yīng)03,T003233140527170802發(fā)送成功，將返回“狀態(tài)碼，響應(yīng)ID”匹配狀態(tài)報(bào)告時(shí)，請(qǐng)將響應(yīng)ID+手機(jī)號(hào)匹配到唯一短消息響應(yīng)ID格式：一位字母+18位數(shù)字失敗響應(yīng)04發(fā)送失敗，將返回“狀態(tài)碼”詳情見下表4

3、. 返回參數(shù)說明返回編號(hào)類型說明00int多個(gè)手機(jī)號(hào)請(qǐng)求發(fā)送成功02intIP限制03int單個(gè)手機(jī)號(hào)請(qǐng)求發(fā)送成功04int用戶名錯(cuò)誤05int密碼錯(cuò)誤07int發(fā)送時(shí)間有誤08int內(nèi)容有誤09int手機(jī)號(hào)碼有誤10int擴(kuò)展號(hào)碼有誤11int余額不足-1int服務(wù)器內(nèi)部異常5. 調(diào)用URL示例調(diào)用前將Content用URLEncoder.encode(Content, "UTF-8");進(jìn)行編碼8:8082/SendMT/SendMessage?CorpID=1001&Pwd=123&Cell=0088&Mob

4、ile=XXX&Content=%D%E或使用域名：:8082/SendMT/SendMessage?CorpID=*&Pwd=*&Mobile=*&Content=*6. 發(fā)送長短信長短信采用服務(wù)端拆分方式，短信內(nèi)容超出70個(gè)字為長短信，拆分后的長短信每條內(nèi)容最長為67個(gè)字。長短信按67個(gè)字為一條來計(jì)費(fèi)，不超出70個(gè)字的為一條普通短信，普通短信按70個(gè)字計(jì)費(fèi)。二、 上行與狀態(tài)報(bào)告上行短信與狀態(tài)報(bào)告需第三方（客戶方）提供一個(gè)HTTP訪問地址，短信平臺(tái)為發(fā)送方，客戶為接收方，采取HTTP POST推送的方式，短信平臺(tái)收到客戶方服務(wù)器返回的HTTP 200響應(yīng)作為發(fā)

5、送依據(jù)，如果返回不是HTTP 200響應(yīng)，短信平臺(tái)會(huì)有三次重發(fā)，三次重發(fā)失敗記做發(fā)送失敗。1. 接口命名接口名URL說明MOhttp:/ip:port/MO需客戶方提供2. 上行、狀態(tài)報(bào)告參數(shù)采用自定義消息格式。體積小，信息量大。狀態(tài)報(bào)告和上行消息不會(huì)在同一個(gè)包中出現(xiàn)，每個(gè)包中最多不會(huì)超過50條消息。每條消息之間分隔符為英文“;” 每條消息內(nèi)分隔符為英文“,”Post傳出參數(shù)名dxstr參數(shù)順序說明備注第一個(gè)消息類型0為上行消息2為狀態(tài)報(bào)告第二個(gè)手機(jī)號(hào)手機(jī)號(hào)碼第三個(gè)上行消息時(shí)為擴(kuò)展號(hào)碼狀態(tài)報(bào)告時(shí)為消息狀態(tài)上行消息時(shí)內(nèi)容為Cell狀態(tài)報(bào)告內(nèi)容0為成功其他失敗第四個(gè)上行消息時(shí)為內(nèi)容狀態(tài)報(bào)告時(shí)為消息

6、的包ID上行內(nèi)容經(jīng)過GBK編碼，需客戶解碼例如： URLDecoder.decode(Content, "GBK");第五個(gè)接收時(shí)間時(shí)間格式：yyyyMMddHHmmss 14位串小時(shí)采用24小時(shí)制3. 上行示例http:/ip:port/MO?dxstr=01234,%C9%CF%D0%D01,20140428172543;01234,%C9%CF%D0%D02,20140428172543;4. 狀態(tài)報(bào)告示例http:/ip:port/MO?dxstr=20,T165245140224152846,20140428172543;20,T165246140224152846,20140428172543;三、 余額查詢接口1. 接口地址8:8082/SendMT/SearchStatus提交方式：POST/GET編碼：UTF-82. 調(diào)用參數(shù)說明參數(shù)名是否可選類型說明username必選string帳號(hào)名稱password必選string密碼3