一、下载源码
C# DEMO下载二、使用帮助
2.1 DEMO结构
说明:
1、HTTPHelper.cs:此类中封装了POST请求,开发者可以参考使用; 2、MSGHelper.cs:此类中实现了江苏美圣HTTP协议下的所有短信接口,开发者在此类中初始化参数即可; 3、HttpDemo.aspx:此页面中演示了如何调用短信接口。
2.2 初始参数
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 | /// 〈summary> /// MSGHelper 这是调用接口的公用方法,项目里直接引用 ,但是下面的参数需要用户自行修改 /// 〈/summary〉 public class MSGHelper { /// 〈summary〉 /// 短信帐号 /// 〈/summary〉 static String username = "JSM******" ; /// 〈summary> /// 登录密码 /// 〈/summary〉 static String password = "******" ; /// 〈summary〉 /// 校验码/通讯Key /// 〈/summary〉 static String veryCode = "******" ; } |
2.3 接口使用
2.3.1 普通短信
1 | string result = MSGHelper.SendTextSms( "接收者手机号码" , "自定义短信内容" ); |
普通短信接口的调用只需开发者传递接收者手机号和短信内容两个参数。普通短信需要人工审核,因此短信有可能会有一定的延迟。如果发送验证码类等其他需要即时接收的短信请使用模板短信,请看下一节。
2.3.2 模板短信
1 | string result = MSGHelper.SendTemplateSms( "接收者手机号码" , "模板编号" , "@1@=1234测试" ); |
模板短信免审核,即时到达
2.3.3 获取状态报告
1 | string result = MSGHelper.QueryReport(); |
只允许查询当天的,已获取的状态报告后续不会再获取
2.3.4 获取上行短信
1 | string result = MSGHelper.QueryMo(); |
只允许查询当天的,已获取的上行短信后续不会再获取
2.3.5 获取余额
1 | string result = MSGHelper.GetAmount(); |
提示:如果需要对接口返回的XML做解析,下面提供一种解析方法供参考。
1 2 3 4 5 | XmlDocument xDoc = new XmlDocument(); xDoc.LoadXml(result); XmlNodeList xmlNodeList = xDoc.SelectNodes( "/sms/mt" ); string status = (xmlNodeList[0].SelectSingleNode( "//status" )).InnerText; //satus是返回值中的状态码 |