一、配置文件app.config
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<sectionGroup name="applicationSettings" type="System.Configuration.ApplicationSettingsGroup, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" >
<section name="Functions.Properties.Settings" type="System.Configuration.ClientSettingsSection, System, Version=2.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" requirePermission="false" />
</sectionGroup>
</configSections>
<applicationSettings>
<Functions.Properties.Settings>
<setting name="Functions_sdk_WebService" serializeAs="String">
<value>http://sdk.leiyusoft.com:8060/webservice.asmx</value>
</setting>
</Functions.Properties.Settings>
</applicationSettings>
</configuration>
二、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();
/// <summary>
/// 普通群发短信mt方法
/// </summary>
/// <param name="sn">序列号</param>
/// <param name="pwd">密码要MD5(SN+PWD)加密，取32位大写</param>
/// <param name="mobiles">手机号列表</param>
/// <param name="content">短信内容</param>
/// <param name="ext">扩展码</param>
/// <param name="stime">定时时间</param>
/// <param name="rrid">流水号</param>
/// <returns>发送结果</returns>
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);
}
/// <summary>
/// 个性群发短信gxmt方法
/// </summary>
/// <param name="sn">序列号</param>
/// <param name="pwd">密码要MD5(SN+PWD)加密，取32位大写</param>
/// <param name="mobiles">手机号列表</param>
/// <param name="content">短信内容,要经过URLgb2312编码和手机号对应好</param>
/// <param name="ext">扩展码</param>
/// <param name="stime">定时时间</param>
/// <param name="rrid">流水号</param>
/// <returns>发送结果</returns>
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);
}
/// <summary>
/// 普通群发短信mdSmsSend_u方法
/// </summary>
/// <param name="sn">序列号</param>
/// <param name="pwd">密码要MD5(SN+PWD)加密，取32位大写</param>
/// <param name="mobiles">手机号列表</param>
/// <param name="content">短信内容,要经过URLutf-8编码</param>
/// <param name="ext">扩展码</param>
/// <param name="stime">定时时间</param>
/// <param name="rrid">流水号</param>
/// <returns>发送结果</returns>
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);
}
/// <summary>
/// 查询短信剩余条数
/// </summary>
/// <param name="sn">序列号</param>
/// <param name="pwd">密码要MD5(SN+PWD)加密，取32位大写</param>
/// <returns>短信剩余条数</returns>
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.leiyusoft.com:8060/webservice.asmx?op=balance
示例：序列号SDK-SSD-010-00001 密码 xxxxxx
参数输入：
SN= SDK-SSD-010-00001
PWD= 3B5D3C427365F40C1D27682D78BB31E0
示例返回结果: 余额79109条短信
XML格式:
具体函数C#实现：
/// <summary>
/// 获取余额
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
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.leiyusoft.com:8060/webservice.asmx?op=mt
示例1
SN= SDK-SSD-010-00001
PWD=3B5D3C427365F40C1D27682D78BB31E0
Mobile:139***404,138***213…………….
Content:测试
Ext: ""
Stime: ""
Rrid: ""
输出结果:
XML格式:
具体函数C#实现：
/// <summary>
/// 发送短信
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
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.leiyusoft.com: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,13817885229";
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.leiyusoft.com:8060/webservice.asmx （一般调用）
多线程接口地址：http://sdk.leiyusoft.com: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.leiyusoft.com:8060/webservice.asmx
地址2：http://sdk2.leiyusoft.com:8060/webservice.asmx
这些地址都是标准的webservice地址，C#，Java客户可以按照自己熟悉的方式去解析String
或者
地址1：http://sdk.leiyusoft.com:8060/webservice.asmx?wsdl
地址2：http://sdk2.leiyusoft.com:8060/webservice.asmx?wsdl
八、示例Demo源代码下载：
3215
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
