億橙短信平臺(tái)短信接口Http

1、客戶接口說明客戶接口說明1第一章 發(fā)送接口21.1 請(qǐng)求地址21.2參數(shù)說明21.3返回值2第二章 余額及已發(fā)送量查詢接口32.1 請(qǐng)求地址32.2參數(shù)說明32.3返回值4第三章 非法關(guān)鍵詞查詢43.1 請(qǐng)求地址43.2參數(shù)說明43.3返回值5第四章 狀態(tài)報(bào)告接口54.1 請(qǐng)求地址54.2參數(shù)說明54.3返回值54.4錯(cuò)誤返回值狀態(tài)報(bào)告請(qǐng)求錯(cuò)誤返回格式及對(duì)應(yīng)值6第五章 上行接口75.1 請(qǐng)求地址75.2參數(shù)說明75.3返回值75.4錯(cuò)誤返回值回復(fù)請(qǐng)求錯(cuò)誤返回格式及對(duì)應(yīng)值8第六章 密碼修改接口86.1 請(qǐng)求地址86.2參數(shù)說明86.3返回值9接口說明：客戶接口部分提供http url方式的接口，

2、根據(jù)客戶需求可以提供相應(yīng)接口。第一章 發(fā)送接口1.1 請(qǐng)求地址請(qǐng)求地址是客戶接口程序調(diào)用時(shí)請(qǐng)求的url地址，采用的是http post 接口，地址是25:5577/sms.aspx 對(duì)應(yīng)UTF-825:5577/smsGBK.aspx 對(duì)應(yīng)GB2312入口地址一般不會(huì)發(fā)生變化，當(dāng)發(fā)生變化的時(shí)候，會(huì)通知接口用戶1.2參數(shù)說明25:5577/sms.aspx25:5577/smsGBK.aspx參數(shù)名稱含義說明userid企業(yè)id企業(yè)IDaccount發(fā)送用戶帳號(hào)用戶帳號(hào)

3、，由系統(tǒng)管理員password發(fā)送帳號(hào)密碼用戶賬號(hào)對(duì)應(yīng)的密碼mobile全部被叫號(hào)碼發(fā)信發(fā)送的目的號(hào)碼.多個(gè)號(hào)碼之間用半角逗號(hào)隔開 content發(fā)送內(nèi)容短信的內(nèi)容，內(nèi)容需要UTF-8編碼sendTime定時(shí)發(fā)送時(shí)間為空表示立即發(fā)送，定時(shí)發(fā)送格式2010-10-24 09:08:10action發(fā)送任務(wù)命令設(shè)置為固定的:sendextno擴(kuò)展子號(hào)請(qǐng)先詢問配置的通道是否支持?jǐn)U展子號(hào)，如果不支持，請(qǐng)?zhí)羁?。子?hào)只能為數(shù)字，且最多10位數(shù)。例如：action=send&userid=12&account=賬號(hào)&password=密碼&mobile/p>

4、amp;content=內(nèi)容&sendTime=&extno=1.3返回值在接收到客戶端發(fā)送的http請(qǐng)求后，返回以xml的方式返回處理結(jié)果。格式為：<?xml version="1.0" encoding="utf-8" ?><returnsms><returnstatus>status</returnstatus> - 返回狀態(tài)值：成功返回Success 失敗返回：Faild<message>message</message> - 返回信

5、息：見下表<remainpoint> remainpoint</remainpoint> - 返回余額<taskID>taskID</taskID> - 返回本次任務(wù)的序列ID<successCounts>successCounts</successCounts> -成功短信數(shù)：當(dāng)成功后返回提交成功短信數(shù)</returnsms>返回信息提示說明ok提交成功用戶名或密碼不能為空提交的用戶名或密碼為空發(fā)送內(nèi)容包含sql注入字符包含sql注入字符用戶名或密碼錯(cuò)誤表示用戶名或密碼錯(cuò)誤短信號(hào)碼不能為空提交的被叫號(hào)碼為空短

6、信內(nèi)容不能為空發(fā)送內(nèi)容為空包含非法字符：表示檢查到不允許發(fā)送的非法字符對(duì)不起，您當(dāng)前要發(fā)送的量大于您當(dāng)前余額當(dāng)支付方式為預(yù)付費(fèi)是，檢查到賬戶余額不足其他錯(cuò)誤其他數(shù)據(jù)庫操作方面的錯(cuò)誤第二章 余額及已發(fā)送量查詢接口2.1 請(qǐng)求地址請(qǐng)求地址是客戶接口程序調(diào)用的時(shí)候請(qǐng)求的url地址，采用的是http post接口，地址是25:5577/sms.aspx25:5577/smsGBK.aspx入口地址一般不會(huì)發(fā)生變化，當(dāng)發(fā)生變化的時(shí)候，會(huì)通知接口用戶2.2參數(shù)說明參數(shù)名稱含義說明userid企業(yè)id企業(yè)IDaccount用戶帳號(hào)用戶帳號(hào)，由系

7、統(tǒng)管理員password帳號(hào)密碼用戶賬號(hào)對(duì)應(yīng)的密碼action任務(wù)名稱設(shè)置為固定的：overage例如：action=overage&userid=12&account=賬號(hào)&password=密碼2.3返回值<?xml version="1.0" encoding="utf-8" ?><returnsms><returnstatus>status</returnstatus>-返回狀態(tài)值：成功返回Sucess (注意：此處是Sucess，和其它接口返回的Success不同)失敗返回

8、：Faild<message>message</message>-返回信息提示：見下表<payinfo>payinfo</payinfo>-返回支付方式 后付費(fèi)，預(yù)付費(fèi)<overage>overage</overage>-返回余額<sendTotal>sendTotal</sendTotal>-返回總點(diǎn)數(shù) 當(dāng)支付方式為預(yù)付費(fèi)是返回總充值點(diǎn)數(shù)</returnsms>返回信息提示說明返回空查詢成功將返回相應(yīng)的支付方式、賬戶使用條數(shù)、總充值點(diǎn)數(shù)用戶名或密碼不能為空提交的用戶名或密碼為空用戶名或

9、密碼錯(cuò)誤表示用戶名或密碼錯(cuò)誤第三章 非法關(guān)鍵詞查詢3.1 請(qǐng)求地址請(qǐng)求地址是客戶接口程序調(diào)用的時(shí)候請(qǐng)求的url地址，采用的是http post接口，地址是25:5577/sms.aspx25:5577/smsGBK.aspx入口地址一般不會(huì)發(fā)生變化，當(dāng)發(fā)生變化的時(shí)候，會(huì)通知接口用戶3.2參數(shù)說明參數(shù)名稱含義說明userid企業(yè)id企業(yè)IDaccount用戶帳號(hào)用戶帳號(hào)，由系統(tǒng)管理員password帳號(hào)密碼用戶賬號(hào)對(duì)應(yīng)的密碼action任務(wù)名稱設(shè)置為固定的：checkkeywordcontent檢測(cè)發(fā)送內(nèi)容需要發(fā)送的內(nèi)容例如：act

10、ion=checkkeyword&userid=12&account=賬號(hào)&password=密碼&content=內(nèi)容3.3返回值<?xml version="1.0" encoding="utf-8" ?><returnsms><message>message</message>-返回信息提示：見下表</returnsms>返回信息提示說明用戶名或密碼不能為空提交的用戶名或密碼為空用戶名或密碼錯(cuò)誤表示用戶名或密碼錯(cuò)誤包含非法字符檢查出來包含非法關(guān)鍵詞沒有包含屏

11、蔽詞未檢查出非法關(guān)鍵詞第四章 狀態(tài)報(bào)告接口4.1 請(qǐng)求地址請(qǐng)求地址是客戶接口程序調(diào)用的時(shí)候請(qǐng)求的url地址，采用的是http post接口，地址是25:5577/statusApi.aspx入口地址一般不會(huì)發(fā)生變化，當(dāng)發(fā)生變化的時(shí)候，會(huì)通知接口用戶注意：相同的狀態(tài)報(bào)告，只能獲取一次。4.2參數(shù)說明參數(shù)名稱含義說明userid企業(yè)id企業(yè)IDaccount用戶帳號(hào)用戶帳號(hào)，由系統(tǒng)管理員password帳號(hào)密碼用戶賬號(hào)對(duì)應(yīng)的密碼statusNum每次取得號(hào)碼數(shù)必須為數(shù)字，默認(rèn)4000，可不填action任務(wù)名稱設(shè)置為固定的：query例如：action=query&

12、amp;userid=12&account=賬號(hào)&password=密碼4.3返回值<?xml version="1.0" encoding="utf-8" ?> <returnsms><statusbox><mobile>lt;/mobile>-對(duì)應(yīng)的手機(jī)號(hào)碼<taskid>1212</taskid>-同一批任務(wù)ID<status>10</status>-狀態(tài)報(bào)告-10：發(fā)送成功，20：發(fā)送失敗<recei

13、vetime>2011-12-02 22:12:11</receivetime>-接收時(shí)間<errorcode>DELIVRD</errorcode>-上級(jí)網(wǎng)關(guān)返回值，不同網(wǎng)關(guān)返回值不同，僅作為參考<extno>01</extno>-子號(hào)，即自定義擴(kuò)展號(hào)</statusbox><statusbox><mobile>lt;/mobile><taskid>1212</taskid><status>20</status>&

14、lt;receivetime>2011-12-02 22:12:11</receivetime><errorcode>2</errorcode><extno></extno></statusbox></returnsms>4.4錯(cuò)誤返回值狀態(tài)報(bào)告請(qǐng)求錯(cuò)誤返回格式及對(duì)應(yīng)值<?xml version="1.0" encoding="utf-8" ?> <returnsms><errorstatus><error>1<

15、/error>-錯(cuò)誤碼<remark>用戶名或密碼不能為空</remark>-錯(cuò)誤描述</errorstatus></returnsms>1：用戶名或密碼不能為空2：用戶名或密碼錯(cuò)誤3：該用戶不允許查看狀態(tài)報(bào)告4：參數(shù)不正確第五章 上行接口5.1 請(qǐng)求地址請(qǐng)求地址是客戶接口程序調(diào)用的時(shí)候請(qǐng)求的url地址，采用的是http post接口，地址是25:5577/callApi.aspx入口地址一般不會(huì)發(fā)生變化，當(dāng)發(fā)生變化的時(shí)候，會(huì)通知接口用戶注意：相同的上行回復(fù)，只能獲取一次。5.2參數(shù)說明參數(shù)名稱含義說明use

16、rid企業(yè)id企業(yè)IDaccount用戶帳號(hào)用戶帳號(hào)，由系統(tǒng)管理員password帳號(hào)密碼用戶賬號(hào)對(duì)應(yīng)的密碼action任務(wù)名稱設(shè)置為固定的：query例如：action=query&userid=12&account=賬號(hào)&password=密碼5.3返回值<?xml version="1.0" encoding="utf-8" ?> <returnsms><callbox><mobile>lt;/mobile>-對(duì)應(yīng)的手機(jī)號(hào)碼<taskid&g

17、t;1212</taskid>-同一批任務(wù)ID<content>你好，我不需要</content>-上行內(nèi)容<receivetime>2011-12-02 22:12:11</receivetime>-接收時(shí)間<extno>01</extno>-子號(hào)，即自定義擴(kuò)展號(hào)</callbox><callbox><mobile>lt;/mobile><taskid>1212</taskid><content>你好，本次活

18、動(dòng)路線是怎么的</content><receivetime>2011-12-02 22:12:11</receivetime><extno>01</extno></callbox></returnsms>5.4錯(cuò)誤返回值回復(fù)請(qǐng)求錯(cuò)誤返回格式及對(duì)應(yīng)值<?xml version="1.0" encoding="utf-8" ?> <returnsms><errorstatus><error>1</error>-錯(cuò)誤碼<remark>用戶名或密碼不能為空</remark>-錯(cuò)誤描述</errorstatus></returnsms>1：用戶名或密碼不能為空2：用戶名或密碼錯(cuò)誤3：該用戶不允許查看狀態(tài)報(bào)告4：參數(shù)不正確第六章 密碼修改接口6.1 請(qǐng)求地址請(qǐng)求地址是客戶接口程序調(diào)用的時(shí)候請(qǐng)求的url地址，采用的是http post接口，地址是25:5577/sms.aspx25:5577/sm