短信接口如何對接

      短信接口系列嵌入型，标準化開發包，友善快捷的與企業現有的網站、APP、CRM、OA、ERP等系統進行無縫對接。支援 VB 、PHP、Delphi、.NET、VC 、 JAVA 等多種主流開發語言及 Windows 、Linux 、Unix 等運作環境的通信開發接口，企業資料的安全性極高，降低開發周期和成本，輕松實作短消息網關的連接配接和企業移動商務應用。适用于網站會員手機驗證、App安全驗證、訂單通知、快遞跟蹤、會員提醒等短信應用。

發送接口支援HTTP和WebService

HTTP接口協定

1、發送接口

客戶接口程式調用時請求的url位址，采用的是http post 接口

請求位址：http://dc.28inter.com/sms.aspx 對應UTF-8

http://dc.28inter.com/smsGBK.aspx 對應GB2312

參數名稱	含義	說明
userid	企業id	使用者ID，由管理配置設定賬号的時候生成
account	使用者帳号	使用者帳号，由系統管理者配置設定
password	帳号密碼	使用者賬号對應的密碼
mobile	全部被叫号碼	發送目标号碼，多個号碼之間用半形逗號隔開
content	發送内容	短信的内容，内容需要UTF-8編碼
sendTime	定時發送時間	為空表示立即發送，定時發送格式2010-10-24 09:08:10
action	發送任務指令	設定為固定的:send
extno	擴充子号	請先詢問配置的通道是否支援擴充子号，如果不支援，請填空。子号隻能為數字，且最多5位數

例如：action=send&userid=12&account=賬号&password=密碼&mobile=15012345678,13512345678&content=内容&sendTime=&extno=

傳回值

傳回資訊提示	說明
ok	送出成功
使用者名或密碼不能為空	送出的使用者名或密碼為空
發送内容包含sql注入字元	包含sql注入字元
使用者名或密碼錯誤	表示使用者名或密碼錯誤
短信号碼不能為空	送出的被叫号碼為空
短信内容不能為空	發送内容為空
包含非法字元	表示檢查到不允許發送的非法字元
對不起，您目前要發送的量大于您目前餘額	當支付方式為預付費是，檢查到賬戶餘額不足
其他錯誤	其他資料庫操作方面的錯誤

在接收到用戶端發送的http請求後，傳回以xml的方式傳回處理結果。格式為：

<xml version="1.0" encoding="utf-8">

<returnsms>

<returnstatus><status></returnstatus >---------- 傳回狀态值：成功傳回Success 失敗傳回：Faild

<message><message></message>---------- 傳回資訊

<remainpoint><remainpoint></remainpoint>---------- 傳回餘額

<taskID><taskID></taskID>----------- 傳回本次任務的序列ID

<successCounts><successCounts></successCounts>--成功短信數：當成功後傳回送出成功短信數

</returnsms>

2、餘額及已發送量查詢接口

請求位址：http://dc.28inter.com/sms.aspx 對應UTF-8

http://dc.28inter.com/smsGBK.aspx 對應GB2312

參數名稱	含義	說明
userid	企業id	使用者ID，由管理配置設定賬号的時候生成
account	使用者帳号	使用者帳号，由系統管理者配置設定
password	帳号密碼	使用者賬号對應的密碼
action	任務名稱	設定為固定的：overage

例如：action=overage&userid=12&account=賬号&password=密碼

傳回值

傳回資訊提示	說明
傳回成功	查詢成功将傳回相應的支付方式、賬戶使用條數、總充值點數
使用者名或密碼不能為空	送出的使用者名或密碼為空
使用者名或密碼錯誤	表示使用者名或密碼錯誤

傳回以xml的方式傳回處理結果。格式為：

<xml version="1.0" encoding="utf-8">

<returnsms>

<returnstatus><status></returnstatus>-------傳回狀态值：成功傳回Success 失敗傳回：Faild

<message><message></message>--------------傳回資訊提示

<payinfo><payinfo></payinfo>--------------傳回支付方式 後付費，預付費

<overage><overage></overage>-------------傳回餘額

<sendTotal><sendTotal></sendTotal>----傳回總點數 當支付方式為預付費是傳回總充值點數

</returnsms>

3、非法關鍵詞查詢

請求位址：http://dc.28inter.com/sms.aspx 對應UTF-8

http://dc.28inter.com/smsGBK.aspx 對應GB2312

參數名稱	含義	說明
userid	企業id	使用者ID，由管理配置設定賬号的時候生成
account	使用者帳号	使用者帳号，由系統管理者配置設定
password	帳号密碼	使用者賬号對應的密碼
action	任務名稱	設定為固定的：checkkeyword
content	檢測發送内容	需要發送的内容

例如：action=checkkeyword&userid=12&account=賬号&password=密碼&content=内容

傳回值

傳回資訊提示	說明
使用者名或密碼不能為空	送出的使用者名或密碼為空
使用者名或密碼錯誤	表示使用者名或密碼錯誤
包含非法字元	檢查出來包含非法關鍵詞
未包含非法字元	未檢查出非法關鍵詞

傳回以xml的方式傳回處理結果。格式為：

<xml version="1.0" encoding="utf-8">

<returnsms>

<message>message</message>--------------傳回資訊提示

</returnsms>

4、狀态報告接口

請求位址：http://dc.28inter.com/statusApi.aspx 對應UTF-8

http://dc.28inter.com/statusApi.aspx 對應GB2312

參數名稱	含義	說明
userid	企業id	使用者ID，由管理配置設定賬号的時候生成
account	使用者帳号	使用者帳号，由系統管理者配置設定
password	帳号密碼	使用者賬号對應的密碼
action	任務名稱	設定為固定的：query

例如：action=query&userid=12&account=賬号&password=密碼

傳回以xml的方式傳回處理結果。格式為：

<xml version="1.0" encoding="utf-8">

<returnsms>

<statusbox>

<mobile>15012345678</mobile>-------------對應的手機号碼

<taskid>1212</taskid>-------------同一批任務ID

<status>10</status>---------狀态報告----10：發送成功，20：發送失敗

<receivetime>2011-12-02 22:12:11</receivetime>-------------接收時間

<errorcode>DELIVRD</errorcode>-上級網關傳回值，不同網關傳回值不同，僅作為參考

</statusbox>

<statusbox>

<mobile>15012345678</mobile>

<taskid>1212</taskid>

<status>20</status>

<receivetime>2011-12-02 22:12:11</receivetime>

<errorcode>2</errorcode>

</statusbox>

</returnsms>

5、上行接口

請求位址：http://dc.28inter.com/callApi.aspx 對應UTF-8

http://dc.28inter.com/callApi.aspx 對應GB2312

參數名稱	含義	說明
userid	企業id	使用者ID，由管理配置設定賬号的時候生成
account	使用者帳号	使用者帳号，由系統管理者配置設定
password	帳号密碼	使用者賬号對應的密碼
action	任務名稱	設定為固定的：query

例如：action=query&userid=12&account=賬号&password=密碼

傳回以xml的方式傳回處理結果。格式為：

<xml version="1.0" encoding="utf-8">

<returnsms>

<callbox>

<mobile>15012345678</mobile>-------------對應的手機号碼

<taskid>1212</taskid>-------------同一批任務ID

<content>你好，我不需要</content>---------上行内容

<receivetime>2011-12-02 22:12:11</receivetime>-------------接收時間

</callbox>

<callbox>

<mobile>15012345678</mobile>

<taskid>1212</taskid>

<content>你好，本次活動路線是怎麼的</content>

<receivetime>2011-12-02 22:12:11</receivetime>

</callbox>

</returnsms>