短信互動平臺

短信互動平臺是基于中國移動、聯通、電信直接提供的全國全網上下行短信接口資源，瀏覽器多點登錄，部署更容易，使用更簡單；靈活創建短信互動活動；實時短信接收與自動回復；短信互動平臺區別于傳統的短信平臺在于有效遏制了垃圾短信的產生。

短信互動平臺部分功能菜單

短信接口系列嵌入型，標準化開發包，方便快捷的與企業現有的網站、APP、CRM、OA、ERP等系統進行無縫對接。支持 VB 、PHP、Delphi、.NET、VC 、 JAVA 等多種主流開發語言及 Windows 、Linux 、Unix 等運行環境的通信開發接口，企業資料的安全性極高，降低開發周期和成本，輕松實現短消息網關的連接和企業移動商務應用。

發送接口支持HTTP和WebService

HTTP接口協議

1、發送接口

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

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

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

參數名稱	含義	是否必須	說明
userid	企業id	必須	用戶ID，由管理分配賬號的時候生成
timestamp	時間戳	必須	系統當前時間字符串，年月日時分秒，例如：20120701231212
sign	簽名	必須	使用 賬號+密碼+時間戳 生成MD5字符串作為簽名。MD5生成32位，且需要小寫 例如：賬號是test 密碼是mima 時間戳是20120701231212 就需要用testmima20120701231212 來生成MD5的簽名，生成的簽名為5cc68982f55ac74348e3d819f868fbe1
mobile	全部被叫號碼	必須	發送目標號碼，多個號碼之間用半角逗號隔開
content	發送內容	必須	短信的內容，內容需要UTF-8編碼
sendTime	定時發送時間	可不填	定時短信發送時間。格式為 2010-10-24 09:08:10，不填則默認為立即發送（選填參數），注意定時短信才需要傳值。
action	發送任務命令	必須	設置為固定的:send
extno	擴展子號	可不填	請先詢問配置的通道是否支持擴展子號，如果不支持，請填空。子號只能為數字，且最多5位數
rt	接口類型	必須	固定值 json，不填則為XML格式返回

例如：

action=send&rt=json&userid=12×tamp=20120701231212&sign =5cc68982f55ac74348e3d819f868fbe1&mobile=13568813957,18980062919&content=內容&sendTime=&extno=

返回值

返回信息提示	說明
ok	提交成功
用戶名或密碼不能為空	提交的用戶名或密碼為空
發送內容包含sql注入字符	包含sql注入字符
用戶名或密碼錯誤	表示用戶名或密碼錯誤
短信號碼不能為空	提交的被叫號碼為空
短信內容不能為空	發送內容為空
包含非法字符	表示檢查到不允許發送的非法字符
對不起，您當前要發送的量大于您當前余額	當支付方式為預付費是，檢查到賬戶余額不足
其他錯誤	其他數據庫操作方面的錯誤

（1）、在接收到客戶端發送的http請求后，返回以json的方式返回處理結果。格式為：

{"ReturnStatus":"Success","Message":"ok","RemainPoint":109346,"TaskID":365,"SuccessCounts":2}

ReturnStatus ---------- 返回狀態值：成功返回Success 失敗返回：Faild

Message --------------- 返回信息：見上表

RemainPoint ---------- 返回余額

TaskID --------------- 返回本次任務的序列ID

SuccessCounts -------- 成功短信數：當成功后返回提交成功短信數

（2）、在接收到客戶端發送的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/v2sms.aspx 對應UTF-8

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

參數名稱	含義	說明
userid	企業id	用戶ID，由管理分配賬號的時候生成
timestamp	時間戳	系統當前時間字符串，年月日時分秒，例如：20120701231212
sign	簽名	使用 賬號+密碼+時間戳 生成MD5字符串作為簽名。MD5生成32位，且需要小寫 例如： 賬號是test 密碼是mima 時間戳是20120701231212 就需要用testmima20120701231212 來生成MD5的簽名，生成的簽名為5cc68982f55ac74348e3d819f868fbe1
action	任務名稱	設置為固定的：overage
rt	接口類型	固定值 json，不填則為XML格式返回

例如：

action=overage&rt=json&userid=12×tamp=20120701231212&sign =5cc68982f55ac74348e3d819f868fbe1

返回值

返回信息提示	說明
返回成功	查詢成功將返回相應的支付方式、賬戶使用條數、總充值點數
用戶名或密碼不能為空	提交的用戶名或密碼為空
用戶名或密碼錯誤	表示用戶名或密碼錯誤

（1）、返回以json的方式返回處理結果。格式為：

{"ReturnStatus":"Success","Message":"","Payinfo":"后付費","Overage":109346,"SendTotal":1075}

ReturnStatus-------返回狀態值：成功返回Success 失敗返回：Faild

Message------------返回信息提示：見上表

Payinfo-------------返回支付方式 后付費，預付費

Overage------------返回余額

SendTotal----------返回總點數 當支付方式為預付費是返回總充值點數

（2）、返回以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/v2statusApi.aspx

注意：相同的狀態報告，只能獲取一次。

參數名稱	含義	說明
userid	企業id	用戶ID，由管理分配賬號的時候生成
timestamp	時間戳	系統當前時間字符串，年月日時分秒，例如：20120701231212
sign	簽名	使用 賬號+密碼+時間戳 生成MD5字符串作為簽名。MD5生成32位，且需要小寫 例如： 賬號是test 密碼是mima 時間戳是20120701231212 就需要用testmima20120701231212 來生成MD5的簽名，生成的簽名為5cc68982f55ac74348e3d819f868fbe1
action	任務名稱	設置為固定的：query
statusNum	每次取得號碼數	必須為數字，默認4000，可不填
rt	接口類型	固定值 json，不填則為XML格式返回

例如：

action=query&rt=json&userid=12×tamp=20120701231212&sign =5cc68982f55ac74348e3d819f868fbe1

（1）、返回以json的方式返回處理結果。格式為：

{"ReturnStatus":"Success","Message":"OK","Task":

[{"Mobile":"13568813957","TaskID":"358","Status":"20","ReceiveTime":"2018-08-20 11:20:18","ErrorCode":"UNDELIVERED","ExtNo":""},

{"Mobile":"13568813957","TaskID":"358","Status":"20","ReceiveTime":"2018-08-20 11:20:18","ErrorCode":"UNDELIVERED","ExtNo":""}]}

ReturnStatus--------------返回狀態值：成功返回Success

Message-------------------描述

Task------------------------狀態報告數組隊列

Mobile---------------------對應的手機號碼

TaskID---------------------同一批任務ID

Status----------------------狀態報告----10：發送成功，20：發送失敗

ReceiveTime-------------接收時間

ErrorCode---------------上級網關返回值，不同網關返回值不同，僅作為參考

ExtNo--------------------子號，即自定義擴展號

（2）、返回以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>

4、上行接口

請求地址：http://dc.28inter.com/v2callApi.aspx

注意：相同的上行回復，只能獲取一次。

參數名稱	含義	說明
userid	企業id	用戶ID，由管理分配賬號的時候生成
timestamp	時間戳	系統當前時間字符串，年月日時分秒，例如：20120701231212
sign	簽名	使用 賬號+密碼+時間戳 生成MD5字符串作為簽名。MD5生成32位，且需要小寫 例如： 賬號是test 密碼是mima 時間戳是20120701231212 就需要用testmima20120701231212 來生成MD5的簽名，生成的簽名為5cc68982f55ac74348e3d819f868fbe1
action	任務名稱	設置為固定的：query
ownExt	使用自有擴展號	可不填或為空。當該值為1時，返回的extno將剔除系統強制附加的子號，為客戶自己提交的子號，前提是上級通道支持時。
rt	接口類型	固定值 json，不填則為XML格式返回

例如：

action=query&rt=json&userid=12×tamp=20120701231212&sign =5cc68982f55ac74348e3d819f868fbe1

（1）、返回以json的方式返回處理結果。格式為：

{"ReturnStatus":"Success","Message":"OK","Task":

[{"Mobile":"136","TaskID":"1","Content":"test","ReceiveTime":"2018-12-07 15:17:26","ExtNo":"251251"},

{"Mobile":"136","TaskID":"1","Content":"test","ReceiveTime":"2018-12-07 15:17:26","ExtNo":"251251"}]}

ReturnStatus--------------返回狀態值：成功返回Success

Message-------------------描述

Task------------------------上行數組隊列

Mobile---------------------對應的手機號碼

TaskID--------------------同一批任務ID

Content-------------------上行內容

ReceiveTime-------------接收時間

ExtNo---------------------子號，即自定義擴展號

（2）、返回以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>

短信互動接口代碼示例參考demo請聯系客服索取！