短信接口即企業短信平臺接口(API版)是面向有一定技術開發能力的企業用戶而單獨研發的短信(sms)接口。接口采用了通用的 HTTP,WEBSERVICE,SGIP,CMPP,SMGP等形式,可以支持各種操作系統和開發語言,支持二次開發,可把短信接口嵌入到您自己的系統 中,快速擁有無線應用,完善企業服務。
由于目前短信轟炸機的出現,不少網站都會被其影響,所以建議客戶在對接短信驗碼的同時做好相關限制。
這里推薦幾種限制方法:
1,IP限制,如:一個IP一天只發5條
2,時間限制,如:一分鐘同一個號碼只能發一條
3,手機號的限制 如:一個手機號碼一天只能發條
4,增加圖型驗證碼,能有效杜絕短信轟炸機
請求地址是接口程序調用時請求的url地址,采用的是 Http post 接口,
入口地址 http://sms.37037.com
注:入口地址一般不會發生變化,當發生變化的時候,會通知接口用戶
如域名發送出現提交失敗或其它原因,更換為IP地址,聯系相關負責工作人員
接口說明:
客戶接口部分提供http url方式的接口,根據客戶需求可以提供相應接口,接口編碼方式采用統一的UTF-8
接口文檔下載:
短信接口Http1.0.doc 短信接口Http2.0.doc 短信接口WebService.doc
一:登陸平臺獲取接口參數
使用客戶提供的帳號和密碼登陸:http://sms.37037.com 登陸企業信使平臺,登陸后點擊 接入摘要 如圖
二:根據接口文檔進行對接調試
請求地址是客戶接口程序調用時請求的url地址,采用的是http post 接口,地址是
http://sms.37037.com/sms.aspx 對應UTF-8
http://sms.37037.com/smsGBK.aspx 對應GB2312
入口地址一般不會發生變化,當發生變化的時候,會通知接口用戶
http://sms.37037.com/sms.aspx
http://sms.37037.com/smsGBK.aspx
參數名稱 |
含義 |
說明 |
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=15023239810,13527576163&content=內容&sendTime=&extno=
在接收到客戶端發送的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>
返回信息提示 |
說明 |
ok |
提交成功 |
用戶名或密碼不能為空 |
提交的用戶名或密碼為空 |
發送內容包含sql注入字符 |
包含sql注入字符 |
用戶名或密碼錯誤 |
表示用戶名或密碼錯誤 |
短信號碼不能為空 |
提交的被叫號碼為空 |
短信內容不能為空 |
發送內容為空 |
包含非法字符: |
表示檢查到不允許發送的非法字符 |
對不起,您當前要發送的量大于您當前余額 |
當支付方式為預付費是,檢查到賬戶余額不足 |
其他錯誤 |
其他數據庫操作方面的錯誤 |
請求地址是客戶接口程序調用的時候請求的url地址,采用的是http post接口,地址是
http://sms.37037.com/sms.aspx
http://sms.37037.com/smsGBK.aspx
入口地址一般不會發生變化,當發生變化的時候,會通知接口用戶
參數名稱 |
含義 |
說明 |
userid |
企業id |
企業ID |
account |
用戶帳號 |
用戶帳號,由系統管理員 |
password |
帳號密碼 |
用戶賬號對應的密碼 |
action |
任務名稱 |
設置為固定的:overage |
例如:
action=overage&userid=12&account=賬號&password=密碼
<?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>
返回信息提示 |
說明 |
返回空 |
查詢成功 將返回相應的支付方式、賬戶使用條數、總充值點數 |
用戶名或密碼不能為空 |
提交的用戶名或密碼為空 |
用戶名或密碼錯誤 |
表示用戶名或密碼錯誤 |
請求地址是客戶接口程序調用的時候請求的url地址,采用的是http post接口,地址是
http://sms.37037.com/sms.aspx
http://sms.37037.com/smsGBK.aspx
入口地址一般不會發生變化,當發生變化的時候,會通知接口用戶
參數名稱 |
含義 |
說明 |
userid |
企業id |
企業ID |
account |
用戶帳號 |
用戶帳號,由系統管理員 |
password |
帳號密碼 |
用戶賬號對應的密碼 |
action |
任務名稱 |
設置為固定的:checkkeyword |
content |
檢測發送內容 |
需要發送的內容 |
例如:
action=checkkeyword&userid=12&account=賬號&password=密碼&content=內容
<?xml version="1.0" encoding="utf-8" ?>
<returnsms>
<message>message</message>--------------返回信息提示:見下表
</returnsms>
返回信息提示 |
說明 |
用戶名或密碼不能為空 |
提交的用戶名或密碼為空 |
用戶名或密碼錯誤 |
表示用戶名或密碼錯誤 |
包含非法字符 |
檢查出來包含非法關鍵詞 |
未包含非法字符 |
未檢查出非法關鍵詞 |
請求地址是客戶接口程序調用的時候請求的url地址,采用的是http post接口,地址是
http://sms.37037.com/statusApi.aspx
入口地址一般不會發生變化,當發生變化的時候,會通知接口用戶
參數名稱 |
含義 |
說明 |
userid |
企業id |
企業ID |
account |
用戶帳號 |
用戶帳號,由系統管理員 |
password |
帳號密碼 |
用戶賬號對應的密碼 |
action |
任務名稱 |
設置為固定的:query |
例如:
action=query&userid=12&account=賬號&password=密碼
<?xml version="1.0" encoding="utf-8" ?>
<returnsms>
<statusbox>
<mobile>15023239810</mobile>-------------對應的手機號碼
<taskid>1212</taskid>-------------同一批任務ID
<status>10</status>---------狀態報告----10:發送成功,20:發送失敗
<receivetime>2011-12-02 22:12:11</receivetime>-------------接收時間
</statusbox>
<statusbox>
<mobile>15023239811</mobile>
<taskid>1212</taskid>
<status>20</status>
<receivetime>2011-12-02 22:12:11</receivetime>
</statusbox>
</returnsms>
<?xml version="1.0" encoding="utf-8" ?>
<returnsms>
<errorstatus>
<error>1</error>-------------錯誤碼
<remark>用戶名或密碼不能為空</remark>-------------錯誤描述
</errorstatus>
</returnsms>
1:用戶名或密碼不能為空
2:用戶名或密碼錯誤
3:該用戶不允許查看狀態報告
4:參數不正確
請求地址是客戶接口程序調用的時候請求的url地址,采用的是http post接口,地址是
http://sms.37037.com/callApi.aspx
入口地址一般不會發生變化,當發生變化的時候,會通知接口用戶
參數名稱 |
含義 |
說明 |
userid |
企業id |
企業ID |
account |
用戶帳號 |
用戶帳號,由系統管理員 |
password |
帳號密碼 |
用戶賬號對應的密碼 |
action |
任務名稱 |
設置為固定的:query |
例如:
action=query&userid=12&account=賬號&password=密碼
<?xml version="1.0" encoding="utf-8" ?>
<returnsms>
<callbox>
<mobile>15023239810</mobile>-------------對應的手機號碼
<taskid>1212</taskid>-------------同一批任務ID
<content>你好,我不需要</content>---------上行內容
<receivetime>2011-12-02 22:12:11</receivetime>-------------接收時間
</callbox>
<callbox>
<mobile>15023239811</mobile>
<taskid>1212</taskid>
<content>你好,本次活動路線是怎么的</content>
<receivetime>2011-12-02 22:12:11</receivetime>
</callbox>
</returnsms>
<?xml version="1.0" encoding="utf-8" ?>
<returnsms>
<errorstatus>
<error>1</error>-------------錯誤碼
<remark>用戶名或密碼不能為空</remark>-------------錯誤描述
</errorstatus>
</returnsms>
1:用戶名或密碼不能為空
2:用戶名或密碼錯誤
3:該用戶不允許查看狀態報告
4:參數不正確
三:接口DEMO源碼下載(源碼里的調用參數需要修改)
二次開發ASP接口.Rar 二次開發C#接口.Rar 二次開發JAVA接口.Rar
二次開發PHP接口.Rar 二次開發VB.NET接口.Rar 二次開發Delphi接口.Rar
四:常見問題解答
問:為什么要提供ip地址?
答:為了避免各種原因的帳號盜用情況,造成貴公司短信被濫用,所以我們的系統有ip驗證功能,只發送您這邊認可的ip地址提交的短信。
問:可以提供在線管理平臺嗎?
答:有的,可以登錄平臺查詢余額、修改密碼、發送短信等。網站:http://sms.37037.com
問:有些公司需要報備短信模板,我們需要報備不?
答:不需要報備,我們會有人工審核機制,如果驗證碼及行業應用類,我們是24小時免審。
問:為什么驗證碼剛測試幾條可以收到,后來收不到了?
答:為了防止不法份子用短信轟炸別人,同一個號碼1小時只讓發3次,一天10次。
問:為什么會錯誤提示沒簽名【】
答:現在發送短信都需要加短信簽名,簽名為公司簽稱或品牌簡稱,如:驗證碼為:21515【明網科技】
空格問題
接口是根據用戶提交的短信內容進入全字符匹配的,所有要注意空格的問題
亂碼問題
造成發送收到亂碼問題,一般都是編碼問題引起的,請調整編碼。
咨詢熱線:176-1345-1345 工作時間:周一至周日:8:00-20:00
售后電話:0371-63877133 售后QQ/微信:37037
地址:河南省鄭州市金水區花園路國基路居易摩根中心1401
掃一掃
加關注
Copyright 2008-2022 MingNet All Rights Reserved
增值業務許可證:豫B2-20160055 豫ICP備09005601號 豫公網安備 41010502002208號