天天看點

Http通用短信接口開發經驗及具體開發實作

支援所有開發語言的調用,蘋果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 行動電話 必填
Email 郵件位址 必填
Fax 傳真 必填
Address 位址 必填
Postcode 郵政編碼 必填
Sign 企業簽名 必填

注:使用序列号的第一步即激活序列号的狀态.和使用者進行綁定.如不注冊便發送短信會傳回相應的傳回值-2.除sign參數可為空其它均為必填項.請認真對待這些參數的真實性.短信出現問題聯系不上使用者後果自負.

傳回結果:

XML格式:

Http通用短信接口開發經驗及具體開發實作

文本格式: 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格式:

Http通用短信接口開發經驗及具體開發實作

文本格式:

79109

4.ChargUp充值

參數名稱 說明 備注
Sn 軟體序列号 XXX-XXX-XXX-XXXXX
pwd 密碼 123456 此處為明文
cardno 儲值卡号 儲值卡号 由商務處獲得
cardpwd 儲值卡密碼 充值密碼 由商務處獲得

函數傳回值:string

傳回結果:

XML格式:

Http通用短信接口開發經驗及具體開發實作

文本格式:

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格式:

Http通用短信接口開發經驗及具體開發實作

文本格式:

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格式:

Http通用短信接口開發經驗及具體開發實作

文本格式:

123456

6.mo接收短信

參數名稱 說明 備注
Sn 軟體序列号 格式XXX-XXX-XXX-XXXXX
Pwd 密碼 md5(sn+password) 32位大寫密文

函數傳回值:Stirng 

傳回值說明:mo ID,特服号,手機号,内容(對内容進行gb2312解碼),時間 

如有多條回車換行隔開 \n,一次最多傳回999條短信

傳回結果:

XML格式:

Http通用短信接口開發經驗及具體開發實作

文本格式:

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格式:

Http通用短信接口開發經驗及具體開發實作

文本格式:

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格式:

Http通用短信接口開發經驗及具體開發實作

文本格式:

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通用版接口文檔  所有下載下傳

繼續閱讀