当前位置: 首页 > 短信SDK > C#短信SDK
C#短信SDK
http://sdk.entinfo.cn:8060/webservice.asmx
二、WebService功能函数
using System; using System.Collections.Generic; using System.Text; using System.Web; namespace Functions { public class Function { static sdk.WebService sms = new sdk.WebService(); ////// 普通群发短信mt方法 /// /// 序列号 /// 密码要MD5(SN+PWD)加密,取32位大写 /// 手机号列表 /// 短信内容 /// 扩展码 /// 定时时间 /// 流水号 ///发送结果 public static string Mt(string sn, string pwd, string mobiles, string content, string ext, string stime, string rrid) { string result = sms.mt(sn, pwd, mobiles, content, ext, stime, rrid); return CheckResult(result); } ////// 个性群发短信gxmt方法 /// /// 序列号 /// 密码要MD5(SN+PWD)加密,取32位大写 /// 手机号列表 /// 短信内容,要经过URLgb2312编码和手机号对应好 /// 扩展码 /// 定时时间 /// 流水号 ///发送结果 public static string Gxmt(string sn, string pwd, string mobiles, string content, string ext, string stime, string rrid) { string result = sms.gxmt(sn, pwd, mobiles, content, ext, stime, rrid); return CheckResult(result); } ////// 普通群发短信mdSmsSend_u方法 /// /// 序列号 /// 密码要MD5(SN+PWD)加密,取32位大写 /// 手机号列表 /// 短信内容,要经过URLutf-8编码 /// 扩展码 /// 定时时间 /// 流水号 ///发送结果 public static string MdSmsSend_u(string sn, string pwd, string mobiles, string content, string ext, string stime, string rrid) { string result = sms.mdSmsSend_u(sn, pwd, mobiles, content, ext, stime, rrid); return CheckResult(result); } ////// 查询短信剩余条数 /// /// 序列号 /// 密码要MD5(SN+PWD)加密,取32位大写 ///短信剩余条数 public static string Balance(string sn, string pwd) { string result = sms.balance(sn, pwd); if (result.StartsWith("-")) { return "发送失败!" + GetWhy(result) + "。返回值是:" + result; } return "余额是:" + result; } static string CheckResult(string result) { if (result.StartsWith("-")) { return "发送失败!" + GetWhy(result) + "。返回值是:" + result; } else { return "发送成功。流水号是:" + result; } } static string GetWhy(string code) { switch (code) { case "-2": return "序列号未注册或加密不对"; case "-4": return "余额不足"; case "-6": return "参数错误,请检测所有参数"; case "-7": return "权限受限"; case "-9": return "扩展码权限错误"; case "-10": return "内容过长,短信不得超过500个字符"; case "-20": return "相同手机号,相同内容重复提交"; case "-22": return "Ip鉴权失败"; default: return "错误,请调试程序"; } } } }
三、获取短信账户余额
参数名称 |
说明 |
备注 |
Sn |
软件序列号 |
格式XXX-XXX-XXX-XXXXX |
Pwd |
密码 |
md5(sn+password) 32位大写 密文 +表示连接 |
函数返回值:String(余额)
接口地址:http://sdk.entinfo.cn:8060/webservice.asmx?op=balance
示例:序列号SDK-SSD-010-00001 密码 xxxxxx
参数输入:
SN= SDK-SSD-010-00001
PWD= 3B5D3C427365F40C1D27682D78BB31E0
示例返回结果: 余额79109条短信
XML格式:
具体函数C#实现:////// 获取余额 /// /// /// private void btn_getbalance_Click(object sender, EventArgs e) { sn = tex_sn.Text.Trim(); password = tex_pwd.Text.Trim(); string pwd = getMD5(sn + password); rich_output.Text= Function.Balance(sn, pwd); }
四、普通群发短信
参数名称 |
说明 |
是否必须 |
备注 |
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),此方法推荐用于大量群发.内容相同手机号多个的情况。
接口地址:http://sdk.entinfo.cn:8060/webservice.asmx?op=mt
示例1
SN= SDK-SSD-010-00001
PWD=3B5D3C427365F40C1D27682D78BB31E0
Mobile:139***404,138***213…………….
Content:测试
Ext: ""
Stime: ""
Rrid: ""
输出结果:
XML格式:
具体函数C#实现:
////// 发送短信 /// /// /// private void btn_send_Click(object sender, EventArgs e) { //获取参数 getValues(); //MD5加密密码 string pwd = getMD5(sn + password); rich_output.Text = Function.Mt(sn, pwd, mobile, cont, subcode, stime, ""); }
五、个性群发短信
参数名称 |
说明 |
是否必须 |
备注 |
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用法相同,此方法用于发送多条内容不相同手机号多个的情况)
接口地址:http://sdk.entinfo.cn:8060/webservice.asmx?op=gxmt
需要注意:
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:此处为空(如果填写则系统返回填写内容)
输出结果:
XML格式:
具体函数C#实现:
private void button3_Click(object sender, EventArgs e) { string pwd=getMD5(sn+password); string mobiles = "18636800125,18636924700"; string content1 = "张三您好,您本月实发工资3999元。[雷雨科技]"; content1= HttpUtility.UrlEncode(content1, Encoding.GetEncoding("gb2312")); string content2 = "李四您好,您本月实发工资4999元。[雷雨科技]"; content2 = HttpUtility.UrlEncode(content2, Encoding.GetEncoding("gb2312")); string con = content1 + "," + content2;//短信内容里的逗号要和手机号列表里的个数保持一致 rich_output.Text =Function.Gxmt(sn, pwd, mobiles, con, subcode, stime, ""); }
六、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个数与手机个数不一致 |
|
注:以上返回值针对个别方法.请具体参看每个用到方法的详细说明。
七、附加说明:
1.接口地址:
常用接口地址:http://sdk.entinfo.cn:8060/webservice.asmx (一般调用)
多线程接口地址:http://sdk.entinfo.cn:8061/webservice.asmx (java、andriod使用)
2.其它说明:
(1)开发使用的帐号必须为SDK开头,如SDK-SSD-010-00001,帐号第一次需要调用Register方法注册一次.仅需注册一次即可,信息必须真实
(2)UnRegister与Register配合使用, 连续使用不得超过10次/天;
(3)群发推荐使用接口方法 mt或者mdSmsSend (仅方法名不同);
3. 郑重声明:
(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源代码下载: