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

文本格式: 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通用版接口文档  所有下载