SDK通用版接口调用说明

目录

1 Webservice接口 - 3 -

1.1 webservice返回集合对照表 - 3 -

1.2 Register注册 - 3 -

1.3 balance 查询余额 - 4 -

1.4 ChargUp充值 - 4 -

1.5 mt 发送短信 - 5 -

1.6 mo接收短信 - 6 -

1.7 gxmt 个性发送 - 7 -

2 Http接口 - 9 -

2.1 http返回集合对照表 - 9 -

2.2 发送短信 - 9 -

2.3 接收短信 - 9 -

3 DLL接口 - 10 -

3.1 使用流程 - 10 -

3.2 Register注册 - 10 -

3.3 QueryBalance查询余额 - 11 -

3.4 ChargeFee(软件序列号，卡号,密码) - 11 -

3.5 mt 发送短信 - 12 -

3.6 gxmt 发送个性短信 - 12 -

3.7 ReceiveSMS接收短信 - 13 -

3.8 UpdatePassword修改密码 - 13 -

3.9 ReceiveSMSEx接收子号回复短信 - 13 -

3.10 UnRegister注销账户 - 14 -

4 发送说明 - 14 -

4.1 做单发说明 - 14 -

4.2 做群发说明 - 14 -

4.3 编码说明 - 14 -

4.4 长短信说明 - 14 -

4.5 长短信扣费说明 - 14 -

5 接收说明 - 14 -

6 附加说明 - 15 -

6.1 接口地址 - 15 -

6.2 其它说明 - 15 -

6.3 郑重声明 - 15 -

1 Webservice接口

1.1 webservice返回集合对照表  

注:以上返回值针对个别方法.请具体参看每个用到方法的详细说明。

1.2 Register注册

注:使用序列号的第一步即激活序列号的状态.和使用者进行绑定.如不注册便发送短信会返回相应的返回值-2.除sign参数可为空其它均为必填项.请认真对待这些参数的真实性.短信出现问题联系不上使用者后果自负.

返回结果:

XML格式:

    文本格式: 0 成功。

1.3 balance 查询余额

函数返回值：String（余额）

示例：序列号SDK-BBX-010-00001 密码 123456

参数输入：

SN= SDK-BBX-010-00001

PWD= 3B5D3C427365F40C1D27682D78BB31E0

返回结果:

XML格式:

文本格式:

79109

1.4 ChargUp充值

函数返回值:string

返回结果:

XML格式:

文本格式:

0 成功。

1.5 mt 发送短信

函数返回值：String（唯一标识，即当前发送短信批次的唯一标识,和rrid对应，如为空则返回系统生成的rrid）此方法推荐用于大量群发.内容相同手机号多个

示例1：

输入参数：

SN= SDK-BBX-010-00001

PWD=3B5D3C427365F40C1D27682D78BB31E0

Mobile:139***404,138***213…………….

Content:测试

Ext:21（如果不是网络版，请置空）

Stime: 2009-10-19 16:34:00 （如果不需要定时，请置空）

Rrid:123456 （如果填写则系统返回填写内容，如果置空，返回系统生成的rrid）

输出结果：

XML格式:

文本格式:

123456

示例2

SN= SDK-BBX-010-00001

PWD=3B5D3C427365F40C1D27682D78BB31E0

Mobile:139***404,138***213…………….

Content:测试

Ext:

Stime: 

Rrid: 此处为空

输出结果:

XML格式:

文本格式:

201012300908160937。

1.6 mo接收短信

函数返回值：Stirng

返回值说明：mo ID，特服号，手机号，内容（对内容进行gb2312解码），时间

如有多条回车换行隔开 n

返回结果:

XML格式:

文本格式:

12323666,47512,15201692834,%b2%e2%ca%d41,2010-12-30 9:15:56

注:拆分形式为 先n拆分成数组,然后逗号拆分成数组.根据索引读出需要的数据.内容要GB2312解码。

1.7 gxmt 个性发送

函数返回值：String （唯一标识，即当前发送短信批次的唯一标识,和rrid对应，如为空则返回系统生成的rrid,此处的rrid和mt发送的rrid用法相同,此方法用于发送多条内容不相同手机号多个的情况）

需要注意:

1、手机号以英文逗号隔开

2、发送内容GB2312编码后，以英文逗号隔开，个数和手机号个数一致

3、扩展码可以为空，单个，或多个（以英文逗号隔开，个数和手机号个数一致）

4、定时时间可以为空，单个，或多个（以英文逗号隔开，个数和手机号个数一致）

返回结果:

XML格式:

示例1：

输入参数：

SN= SDK-BBX-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-BBX-010-00001

PWD=3B5D3C427365F40C1D27682D78BB31E0

Mobile:139***404,138***213…………….

Content: %B2%E2%CA%D41, %B2%E2%CA%D42

Ext:

Stime: 

Rrid: 此处为空

输出结果:

XML格式:

文本格式:

201012300908160937。

2 Http接口

2.1 http返回集合对照表

2.2 发送短信

Eg: (单机版)

http://sdk2.entinfo.cn/z_send.aspx?sn=SDK-XXX-010-XXXXX&pwd=888888&mobile=135****4752&content=你好

Eg: (网络版)

http://sdk2.entinfo.cn/z_send.aspx?sn=SDK-XXX-010-XXXXX&pwd=888888&mobile=135****4752&content=你好&ext=1

sn:序列号，pwd:密码，mobile:手机号，用,隔开，content:发送内容，ext:扩展码

注1：如果是第一次使用，请先注册(注册方法请参看附加说明)

注2:HTTP方式只有发送和接收两种方法，其它方法可以通过demo或webservice接口实现其它功能的操作

注:Get由于字符串长度限制,手机号个数请小于等于500

 Post 理论是没有长度限制,但手机号一次不能超过10000.

2.3 接收短信

结果 说明 结果 说明

1 成功 -2 参数错误

-1 发送失败 -3 序列号密码错误

Eg: (单机版)

http://sdk2.entinfo.cn/z_receive.aspx?sn=SDK-XXX-010-XXXXX&pwd=888888

sn:序列号，pwd:密码

注：http方式需保证帐号是正常状态 

Eg: (网络版)

http://sdk2.entinfo.cn/z_receive.aspx?sn=SDK-XXX-010-XXXXX&pwd=888888&ext=子号

sn:序列号，pwd:密码，ext:扩展码(空：接收所有子号码；0：单机版接收；其他：接收此子号码

注：http方式需保证帐号是正常状态

3 DLL接口

3.1 使用流程

 <A>注册组件 方法:开始->运行->输入(CMD) 然后在控制台输入regsvr32.exe空格 c:vbsdk.dll(注：路径为vbsdk.dll的所在路径)

<B>调用Register方法注册帐号

<C>发送短信等其它方法

<注>dll只允许一个帐号在一台服务器上使用，如需多台使用，请参看webservice接口;

同一帐号，只需注册一次，如不更换服务器，不需要注销；

3.2 Register注册

返回值true/false

注:使用序列号的第一步即激活序列号的状态.和使用者进行绑定.如不注册便发送短信会返回false

注册一次即可，不用重复注册,如需更换服务器先在本地上注销，然后再在其它电脑上注册。

3.3 QueryBalance查询余额

函数功能：查询余额

返回值: true/false

3.4 ChargeFee(软件序列号，卡号,密码) 

函数功能：充值

输入参数：

函数返回值：true/false

3.5 mt 发送短信 

函数功能：发送短信

此方法推荐用于大量群发.内容相同手机号多个

函数返回值：true/false

3.6 gxmt 发送个性短信 

此方法推荐用于个性群发.即内容不同多个手机号

Content 需要gb2312编码.如果找不到GB2312的方法,请直接调用dll里的urlencoded 将需要编码的string 传入 会返回编码好的字符串.

需要注意:

1、手机号以英文逗号隔开

2、发送内容GB2312编码后，以英文逗号隔开，个数和手机号个数一致

3、扩展码可以为空，单个，或多个（以英文逗号隔开，个数和手机号个数一致）

4、定时时间可以为空，单个，或多个（以英文逗号隔开，个数和手机号个数一致）

返回结果: true/false

3.7 ReceiveSMS接收短信 

函数功能：接收短信

输入参数：

函数返回值：true/false

(需要自定义接收变量,详看demo)

注：信息接收后不能再次接收。

3.8 UpdatePassword修改密码 

函数功能：更改密码

输入参数：

函数返回值：true/false

3.9 ReceiveSMSEx接收子号回复短信 

函数功能：接收短信

输入参数：

函数返回值：true/false

(需要自定义接收变量,详看demo)

注1：每个子号只能接收自己子号的信息，如特服号为12345,子号1只能接收123451号上的短信，ext为空串可接收所有子号MO的信息；信息接收一次便不能再接收。

注2：根据用户需求由客服开通，子号以数字1开始，不得以0开头，如01,001…

3.10 UnRegister注销账户

函数功能：注销

输入参数：

函数返回值：true/false

4 发送说明

4.1 做单发说明

（每次提交只有一个手机号）时，在一个时间点需要发送N条

相同内容不得超过20次.如果需要发送大量的单条信息并且内容不相同,请参考gxmt的方法;

4.2 做群发说明

(提交内容相同)时,请参看mt 的使用方法,禁止连续一条一条的提交.

4.3 编码说明

接口所有方法都是gb2312编码，使用时请进行相应转换

4.4 长短信说明

一次提交内容最大是600字节 300汉字(建议290汉字) 此时出现长短信的概念.

4.5 长短信扣费说明

如果一次提交小于等于70字符 系统会默认为一条短信发出 扣费一条

如果大于70字符 系统会默认为长短信处理 此时根据长短信前边会加(1/2) 或者(2/2)的标志 此时扣费按65字符扣一条  所以198字符 是 65*3+3  扣费4条 对方如果手机支持长短信则收到一条 如果不支持长短信 则收到四条(建议内容不超过290字符) 纯单字节是140一条,没有长短信的概念。

5 接收说明

l 接收短信间隔最少为5秒；如对回复的短信不急需要请将间隔时间放长.减少对数据库的压力

l 接收短信每条以回车换行符(n)分割，接收内容请进行GB2312解码;

6 附加说明

6.1 接口地址

地址1：http://sdk1.entinfo.cn:8060/webservice.asmx

地址2：http://sdk2.entinfo.cn/webservice.asmx

地址3  http://sdk3.entinfo.cn:8060/webservice.asmx

地址4：http://sdk4.entinfo.cn:8060/webservice.asmx

地址5：http://agent.bucp.net/websend/webservice.asmx

只能使用其中的一个地址,禁止一个账号同时使用多个地址提交

6.2 其它说明

开发使用的帐号必须为SDK开头，如SDK-OFT-010-00001，帐号第一次需要调用Register方法注册一次.仅需注册一次即可,信息必须真实

UnRegister与Register配合使用， 连续使用不得超过10次/天;

群发推荐使用接口方法 mt或者mdSmsSend (仅方法名不同);

单发内容不同(某一时间点) 推荐gxmt(具体请参看gxmt方法介绍)

6.3 郑重声明

1. 禁止相同的内容多个手机号连续一条一条提交. 否则禁用帐号，由此带来损失由客户自行负责.

2.Webservice接口地址向短信平台技术人员索取

        3.所有帐号提交短信，必须提交到同一个服务器4.所有帐号提交短信，必须等上一批提交返回后再提交下一批