支援所有開發語言的調用,蘋果IOS作業系統和WindowsPhone手機作業系統可參考執行。
一、Webservice接口
1.webservice傳回集合對照表:
傳回值 | 傳回值說明 | 問題描述 |
-2 | 帳号/密碼不正确 | 1.序列号未注冊2.密碼加密不正确3.密碼已被修改4.序列号已登出 |
-4 | 餘額不足支援本次發送(或者修改密碼長度不正确) | 餘額不足(或者修改密碼長度不在6位到10位之間) |
-5 | 資料格式錯誤 | 隻能自行調試了。或與技術支援聯系 |
-6 | 參數有誤 | 看參數傳的是否均正常,請調試程式檢視各參數 |
-7 | 權限受限 | 該序列号是否已經開通了調用該方法的權限 |
-8 | 流量控制錯誤 | |
-9 | 擴充碼權限錯誤 | 該序列号是否已經開通了擴充子号的權限,把ext這個參數置空。 |
-10 | 内容長度長 | 單位元組不能超過1000個字元,雙位元組不能超過500個字元 |
-11 | 内部資料庫錯誤 | |
-12 | 序列号狀态錯誤 | 序列号是否被禁用 |
-14 | 伺服器寫檔案失敗 | |
-17 | 沒有權限 | 如發送彩信僅限于SDK3 |
-19 | 禁止同時使用多個接口位址 | 每個序列号送出隻能使用一個接口位址 |
-20 | 相同手機号,相同内容重複送出 | |
-22 | Ip鑒權失敗 | 送出的IP不是所綁定的IP |
-23 | 緩存無此序列号資訊 | |
-601 | 序列号為空,參數錯誤 | |
-602 | 序列号格式錯誤,參數錯誤 | |
-603 | 密碼為空,參數錯誤 | |
-604 | 手機号碼為空,參數錯誤 | |
-605 | 内容為空,參數錯誤 | |
-606 | ext長度大于9,參數錯誤 | |
-607 | 參數錯誤 擴充碼非數字 | |
-608 | 參數錯誤 定時時間非日期格式 | |
-609 | rrid長度大于18,參數錯誤 | |
-610 | 參數錯誤 rrid非數字 | |
-611 | 參數錯誤 内容編碼不符合規範 | |
-623 | 手機個數與内容個數不比對 | |
-624 | 擴充個數與手機個數數 | |
-644 | rrid個數與手機個數不一緻 |
注:以上傳回值針對個别方法.請具體參看每個用到方法的詳細說明。
2.Register注冊(資訊必須真實, 短信出現問題聯系不上使用者後果自負.)
參數名稱 | 說明 | 備注 |
Sn | 軟體序列号 | 格式XXX-XXX-XXX-XXXXX 由商務處獲得 |
Pwd | 密碼 | 6-8位 明文 |
Province | 省 | 必填 |
City | 市 | 必填 |
Trade | 行業 | 必填 |
Entname | 公司名稱 | 必填 |
Linkman | 聯系人 | 必填 |
Phone | 電話 | 必填 |
Mobile | 行動電話 | 必填 |
郵件位址 | 必填 | |
Fax | 傳真 | 必填 |
Address | 位址 | 必填 |
Postcode | 郵政編碼 | 必填 |
Sign | 企業簽名 | 必填 |
注:使用序列号的第一步即激活序列号的狀态.和使用者進行綁定.如不注冊便發送短信會傳回相應的傳回值-2.除sign參數可為空其它均為必填項.請認真對待這些參數的真實性.短信出現問題聯系不上使用者後果自負.
傳回結果:
XML格式:
文本格式: 0 成功。
3.balance 查詢餘額
參數名稱 | 說明 | 備注 |
Sn | 軟體序列号 | 格式XXX-XXX-XXX-XXXXX |
Pwd | 密碼 | md5(sn+password) 32位大寫 密文 +表示連接配接 |
函數傳回值:String(餘額)
示例:序列号SDK-SSD-010-00001 密碼 123456
參數輸入:
SN= SDK-SSD-010-00001
PWD= 3B5D3C427365F40C1D27682D78BB31E0
傳回結果:
XML格式:
文本格式:
79109
4.ChargUp充值
參數名稱 | 說明 | 備注 |
Sn | 軟體序列号 | XXX-XXX-XXX-XXXXX |
pwd | 密碼 | 123456 此處為明文 |
cardno | 儲值卡号 | 儲值卡号 由商務處獲得 |
cardpwd | 儲值卡密碼 | 充值密碼 由商務處獲得 |
函數傳回值:string
傳回結果:
XML格式:
文本格式:
0 成功。
5.mt 普通群發送短信
參數名稱 | 說明 | 是否必須 | 備注 |
Sn | 軟體序列号 | 是 | 格式XXX-XXX-XXX-XXXXX |
Pwd | 密碼 | 是 | md5(sn+password) 32位大寫密文 |
Mobile | 手機号 | 是 | 必填(支援10000個手機号,建議<=5000)多個英文逗号隔開 |
Content | 内容 | 是 | 支援長短信(詳細請看長短信扣費說明) |
Ext | 擴充碼 | 否 | 例如:123(預設置空) |
stime | 定時時間 | 否 | 例如:2010-12-29 16:27:03(非定時置空) |
Rrid | 唯一辨別 | 否 | 最長18位,隻能是數字或者 字母 或者數字+字母的組合 |
函數傳回值:String(唯一辨別,即目前發送短信批次的唯一辨別,和rrid對應,如為空則傳回系統生成的rrid)此方法推薦用于大量群發.内容相同手機号多個
示例1
SN= SDK-SSD-010-00001
PWD=3B5D3C427365F40C1D27682D78BB31E0
Mobile:139***404,138***213…………….
Content:測試
Ext: ""
Stime: ""
Rrid: ""
輸出結果:
XML格式:
文本格式:
201012300908160937。
示例2:
輸入參數:
SN= SDK-SSD-010-00001
PWD=3B5D3C427365F40C1D27682D78BB31E0
Mobile:139***404,138***213…………….
Content:測試
Ext:21(預設,請置空)
Stime: 2009-10-19 16:34:00 (如果不需要定時,請置空)
Rrid:123456 (如果填寫則系統傳回填寫内容,如果置空,傳回系統生成的rrid)
輸出結果:
XML格式:
文本格式:
123456
6.mo接收短信
參數名稱 | 說明 | 備注 |
Sn | 軟體序列号 | 格式XXX-XXX-XXX-XXXXX |
Pwd | 密碼 | md5(sn+password) 32位大寫密文 |
函數傳回值:Stirng
傳回值說明:mo ID,特服号,手機号,内容(對内容進行gb2312解碼),時間
如有多條回車換行隔開 \n,一次最多傳回999條短信
傳回結果:
XML格式:
文本格式:
12323666,47512,15201692834,%b2%e2%ca%d41,2010-12-30 9:15:56
注:拆分形式為 先\n拆分成數組,然後逗号拆分成數組.根據索引讀出需要的資料.内容要GB2312解碼。
如果發送時ext=3 用子号3發送了 那麼調用mo之後 第二個參數47512 就變成了475123了由此可以判斷使用者是回複的那條短信或者哪個應用!
上行隻能取一次,即客戶的回複内容隻能取一次。
或者
使用者提供接收上行的URL,我公司采用post方式推送,有且僅有一個args參數,使用者不得添加其他參數
http://www.url.com/mo.aspx?args=XXXXX
Post 接收部分示例:
Php : $_POST[''args"]
C# : Request["args"]
Java : request.getParameter("args")
XXXX格式如下:
固定值(123456)特服号(與序列号唯一對應,在我公司内部使用),手機号,内容(經過URLgb2312編碼的) ,時間。如果有多條,以英文的";"隔開,我公司采用多線程推送,一個線程最多1000條
123456,132710,15388650501,%b2%e2%ca%d4%b6%cc%d0%c51,2012-5-23 11:38:46;
123456,132710,15321858155,%b2%e2%ca%d4%b6%cc%d0%c52,2012-5-23 11:38:49
傳回:您接收成功後,傳回0.您不傳回值,或傳回其他值,我們的程式都會認為推送失敗了,會緩存5分鐘後,再次請求。但最多會請求10次,即50分鐘後,您還沒有傳回0,我們就會停止推送(會删掉這個失效連結)。
7.gxmt 個性群發短信
參數名稱 | 說明 | 是否必須 | 備注 |
Sn | 軟體序列号 | 是 | 格式XXX-XXX-XXX-XXXXX |
Pwd | 密碼 | 是 | md5(sn+password)32位大寫密文 |
Mobile | 手機号 | 是 | 必填(建議一次最多送出1000個) |
Content | 内容 | 是 | 支援長短信(詳細請看長短信扣費說明) |
Ext | 擴充碼 | 否 | 例如:123(預設置空) |
Stime | 定時時間 | 否 | 例如: 2010-12-30 9:23:20(非定時置空) |
Rrid | 唯一辨別 | 否 | 最長18位 |
函數傳回值:String (唯一辨別,即目前發送短信批次的唯一辨別,和rrid對應,如為空則傳回系統生成的rrid,此處的rrid和mt發送的rrid用法相同,此方法用于發送多條内容不相同手機号多個的情況)
需要注意:
1、手機号以英文逗号隔開
2、發送内容若含有小逗号,整條内容URLGB2312編碼後,以英文逗号隔開,個數和手機号個數一緻
3、擴充碼可以為空,單個,或多個(以英文逗号隔開,個數和手機号個數一緻)
4、定時時間可以為空,單個,或多個(以英文逗号隔開,個數和手機号個數一緻)
傳回結果:
XML格式:
示例1:
輸入參數:
SN= SDK-SSD-010-00001
PWD=3B5D3C427365F40C1D27682D78BB31E0
Mobile:139***404,138***213
Content: %B2%E2%CA%D41, %B2%E2%CA%D42
Ext:(預設,請置空)
Stime: (如果不需要定時,請置空)
Rrid:123456 (如果填寫則系統傳回填寫内容,如果置空,傳回系統生成的rrid)
輸出結果:
XML格式:
文本格式:
123456
示例2
SN= SDK-SSD-010-00001
PWD=3B5D3C427365F40C1D27682D78BB31E0
Mobile:139***404,138***213…………….
Content: %B2%E2%CA%D41, %B2%E2%CA%D42
Ext:
Stime:
Rrid: 此處為空
輸出結果:
XML格式:
文本格式:
201012300908160937。
8.UDPPwd修改密碼
參數名稱 | 說明 | 是否必須 | 備注 |
Sn | 軟體序列号 | 是 | 格式XXX-XXX-XXX-XXXXX |
Pwd | 舊密碼 | 是 | 明文 |
newpwd | 新密碼 | 是 | 明文,新密碼不得小于6位 |
http://sdk.entinfo.cn:8060/webservice.asmx?op=UDPPwd
二、多線程Webservice接口
1.多線程群發普通短信
http://sdk2.entinfo.cn:8061/mdsmssend.ashx?sn=SN&pwd=MD5(sn+password)&mobile=mobile&content=content&ext=&stime=&rrid=&msgfmt=
參數名稱 | 說明 | 是否必須有值 | 備注 |
sn | 軟體序列号 | 是 | 格式XXX-XXX-XXX-XXXXX |
pwd | 密碼 | 是 | md5(sn+password) 32位大寫密文 |
mobile | 手機号 | 是 | 必填(支援10000個手機号,建議<=5000)多個英文逗号隔開 |
Content | 内容 | 是 | 支援長短信(詳細請看長短信扣費說明),URLUTF8編碼 |
Ext | 擴充碼 | 否 | 例如:123(預設置空) |
stime | 定時時間 | 否 | 例如:2010-12-29 16:27:03(置空表示立即發送) |
Rrid | 唯一辨別 | 否 | 最長18位,支援數字。 |
msgfmt | 内容編碼 | 否 | 0:ASCII串。3:短信寫卡操作。4:二進制資訊。空或15:含GB漢字 |
函數傳回值:String(唯一辨別,即目前發送短信批次的唯一辨別,和rrid對應,如為空則傳回系統生成的rrid)
sn即您注冊時的序列号,pwd需要MD5(SN+pwd)加密,取32位大寫。
示例:
http://sdk2.entinfo.cn:8061/mdsmssend.ashx?sn=SDK-SSD-010-XXXXX&pwd=D86555F4EA11EFFA57E8F7DF7AAFFD3F&mobile=137****1021&content=測試&ext=&stime=&rrid=&msgfmt=
2.多線程群發個性短信
http://sdk2.entinfo.cn:8061/mdgxsend.ashx?sn=SN&pwd=MD5(sn+password)&mobile=mobile&content=content&ext=&stime=&rrid=&msgfmt=
參數名稱 | 說明 | 是否必須 有值 | 備注 |
Sn | 軟體序列号 | 是 | 格式XXX-XXX-XXX-XXXXX |
pwd | 密碼 | 是 | md5(sn+password)32位大寫密文 |
mobile | 手機号 | 是 | 必填(建議一次最多送出1000個) |
Content | 内容 | 是 | 内容通過小逗号與手機号一一對應好URLUTF8編碼 |
Ext | 擴充碼 | 否 | 例如:123(預設置空) |
Stime | 定時時間 | 否 | 例如: 2010-12-30 9:23:20(置空表示立即發送) |
Rrid | 唯一辨別 | 否 | 最長18位 |
msgfmt | 内容編碼 | 否 | 0:ASCII串。3:短信寫卡操作。4:二進制資訊。空或15:含GB漢字 |
函數傳回值:String (唯一辨別,即目前發送短信批次的唯一辨別,和rrid對應,如為空則傳回系統生成的rrid,此處的rrid和mdsmssend發送的rrid用法相同,此方法用于發送多條内容不相同手機号不同多個的情況)
示例:
http://sdk2.entinfo.cn:8061/mdgxsend.ashx?sn=SDK-SSD-010-XXXXX&pwd=D86555F4EA11EFFA57E8F7DF7AAFFD3F&mobile=137****1021,137****1022&content=測試1,測試2&ext=&stime=&rrid=&msgfmt=
三、附加說明:
1.号碼程式設計注意事項:
(1)手機号以英文逗号隔開
(2)發送内容若含有小逗号,整條内容URLUTF8編碼編碼後,以英文逗号隔開,個數和手機号個數一緻
(3)擴充碼可以為空,單個,或多個(以英文逗号隔開,個數和手機号個數一緻)
(4)定時時間可以為空,單個,或多個(以英文逗号隔開,個數和手機号個數一緻)
2.長短信扣費說明:
如果一次送出小于等于70字元 系統會預設為一條短信發出 扣費一條
如果大于70字元 系統會預設為長短信處理 此時根據長短信前邊會加(1/2) 或者(2/2)的标志 此時扣費按67字元扣一條 (内容不超過500字元) 純單位元組是140一條,超過140個字元後,按普通長短信收費,即67個字元每條收費。
3.接口位址:
常用接口位址:http://sdk.entinfo.cn:8060/webservice.asmx (一般調用)
多線程接口位址:http://sdk.entinfo.cn:8061/webservice.asmx (java、andriod使用)
4.其它說明:
(1)開發使用的帳号必須為SDK開頭,如SDK-SSD-010-00001,帳号第一次需要調用Register方法注冊一次.僅需注冊一次即可,資訊必須真實
(2)UnRegister與Register配合使用, 連續使用不得超過10次/天;
(3)群發推薦使用接口方法 mt或者mdSmsSend (僅方法名不同);
5. 鄭重聲明:
(1)禁止相同的内容多個手機号連續一條一條送出. 否則禁用帳号,由此帶來損失由客戶自行負責.
(2)請客戶提供外網伺服器IP以便于綁定IP發送,提高賬号的安全性!
(3)在程式裡最好有配置檔案,程式自動判斷當某個接口連接配接逾時送出速度變慢時.程式可以自動切換其它的接口以下是推薦的幾個伺服器,僅接口位址不同而已.方法全部相同;
位址1:http://sdk.entinfo.cn:8060/webservice.asmx
位址2:http://sdk2.entinfo.cn:8060/webservice.asmx
這些位址都是标準的webservice位址,C#,Java客戶可以按照自己熟悉的方式去解析String
或者
位址1:http://sdk.entinfo.cn:8060/webservice.asmx?wsdl
位址2:http://sdk2.entinfo.cn:8060/webservice.asmx?wsdl
四、示例Demo源代碼下載下傳:
SDK通用版接口文檔 所有下載下傳