从源代码中带你解析微信开发
程序员文章站
2022-04-13 21:40:31
...
这两天项目需要在微信上面开一个接口，就研究了一下，过程很艰难，结果很理想，下面我就介绍一下微信开发需要注意的地方。
1，账号问题
/* 首先说第一个你得选择公众平台（开放平台貌似是做应用集成的，这个没有仔细研究，如果有谁了解，希望告诉我一声），在公众平台我们需要注册账号，账号还分两种，个人类型和企业类型，其中个人类型的只能申请订阅号，而企业类型的才可以搞到服务号，订阅号只能手工或者配置一些关键词去做事情，服务号才能部署一些智能的东东，需要高级开发权限只能是服务号，所以如果你是个人，想要针对用户发过来的消息去回复不同的内容，洗洗睡吧。 */
搞开发的都知道上面那段话的意思，是的，我给注释了，我今天在登陆订阅号的时候，发现订阅号也有高级功能的，可能我那个时候没有通过审核吧，OK，不妨碍下面的分享。
2，开发模式
很简单，当你拿到你的服务账号的时候，你会发现，在功能中有个高级功能（在订阅账号里面是没有高级功能这个选项的），之后你可以选择开通哪种方式。目前开发和编辑只能启动一个。
3，配置服务器
微信接口只有一个URL，任何数据都是通过这个URL和你的服务器进行连接的（GET或者POST）都需要走这个接口，下面会说说两个用到的地方。
4，验证服务器
在填写你的服务器URL之后，微信会带上几个参数去访问你的URL，你只需要返回特定的数据就OK了，具体方法也可以查看此链接：http://mp.weixin.qq.com/wiki/index.php?title=%E6%8E%A5%E5%85%A5%E6%8C%87%E5%8D%97
在连接中有部分php的代码可以参考，下面我将我的代码贴一下，在这边我走了很多弯路，所以我尽量贴的全一点
1 /// <summary> 2 /// 验证微信签名 3 /// </summary> 4 /// <param name="sigNature">微信加密签名，signature结合了开发者填写的token参数和请求中的timestamp参数、nonce参数。</param> 5 /// <param name="timestamp">时间戳</param> 6 /// <param name="nonce">随机数</param> 7 /// <param name="echoStr">随机字符串</param> 8 /// <returns>开发者通过检验signature对请求进行校验（下面有校验方式）。若确认此次GET请求来自微信服务器，请原样返回echostr参数内容，则接入生效，成为开发者成功，否则接入失败。</returns> 9 [System.Web.Http.AcceptVerbs("GET")]10 [System.Web.Http.ActionName("Api")]11 [ApiExplorerSettings(IgnoreApi = false)]12 public HttpResponseMessage CheckSignature(string sigNature, string timestamp, string nonce, string echoStr)13 {14 var content =15 string.Format("SigNature:{0}\nTimestamp:{1}\nNonce:{2}\nEchoStr:{3}",16 sigNature, timestamp, nonce, echoStr);17 logger.Debug(content); // 此处的log你可以删掉18 19 var list = new string[] { timestamp, nonce, TOKEN };20 Array.Sort(list);21 var tmpArr = string.Join("", list);22 var tmpStr = FormsAuthentication.HashPasswordForStoringInConfigFile(tmpArr, "SHA1").ToLower();23 24 if (tmpStr == sigNature && !string.IsNullOrEmpty(echoStr)) //根据微信的验证规则做判断25 return Tools.GetReturn(echoStr);26 27 return Tools.GetReturn("error");28 }
之所以写了GetReturn这个函数是因为MVC给我的结果封装了，每次我返回一个字符串的时候他都会在外层添加一对引号，微信还傻不愣登的不认识。。。。这个函数主要就是给我去除MVC封装的
1 public static HttpResponseMessage GetReturn(string message)2 {3 return new HttpResponseMessage4 {5 Content = new StringContent(message, Encoding.UTF8, "text/html")6 };7 }
上面的CheckSignature是一个GET的接口，主要就是验证微信服务的，当然，你仔细研究下微信说的也可以发现，当你收到echoStr的时候，直接return其实就OK了，不必多出验证的步骤。
5，消息接收接口
我只关注了一个功能，当用户发送消息的时候我要回复用户消息，而且只关注文本消息就OK了（其实别的类型的消息原理都差不多）。
我们需要注意这边的几点：
a，此接口的ActionName和上面验证的接口是一样的，这样，他们在外面访问就是相同的URL，只是访问的Method不同罢了。
1 [System.Web.Http.AcceptVerbs("POST")]2 [System.Web.Http.ActionName("Api")]3 [ApiExplorerSettings(IgnoreApi = false)]4 public HttpResponseMessage ReceiveMessage()
b，这种获取消息内容的方法我也是研究了好久才找到的，费死劲了。
1 var message = Request.Content.ReadAsStringAsync().Result;
c，在这个接口他POST过来很多的变量，我都用正则给他搞到了
1 var toUserName = GetItemValue(message, ToUserNameReg);2 var fromUserName = GetItemValue(message, FromUserNameReg);3 var createTime = GetItemValue(message, CreateTimeReg);4 var msgType = GetItemValue(message, MsgTypeReg);5 var content = GetItemValue(message, ContentReg);6 var msgId = GetItemValue(message, MsgIdReg);7 var eventStr = GetItemValue(message, EventReg);8 var eventKey = GetItemValue(message, EventKeyReg);
d，我只关注其中两种类型的事件：event and text，event值得是关注和解除关注，在关注的时候要表示感谢不是；发过来的text，我需要找到回复的内容。
switch (msgType)
{ case "text":
{
} case "event":
{
} default: return Tools.GetReturn("error");
}
e，全部代码在这里：
1 private static readonly Regex ToUserNameReg = new Regex(@"(?<=<ToUserName><!\[CDATA\[).*?(?=\]\]></ToUserName>)", RegexOptions.Compiled);2 private static readonly Regex FromUserNameReg = new Regex(@"(?<=<FromUserName><!\[CDATA\[).*?(?=\]\]></FromUserName>)", RegexOptions.Compiled);3 private static readonly Regex CreateTimeReg = new Regex(@"(?<=<CreateTime>)\d*?(?=</CreateTime>)", RegexOptions.Compiled);4 private static readonly Regex MsgTypeReg = new Regex(@"(?<=<MsgType><!\[CDATA\[).*?(?=\]\]></MsgType>)", RegexOptions.Compiled);5 private static readonly Regex ContentReg = new Regex(@"(?<=<Content><!\[CDATA\[).*?(?=\]\]></Content>)", RegexOptions.Compiled);6 private static readonly Regex MsgIdReg = new Regex(@"(?<=<MsgId>)\d*?(?=</MsgId>)", RegexOptions.Compiled);7 private static readonly Regex EventReg = new Regex(@"(?<=<Event><!\[CDATA\[).*?(?=\]\]></Event>)", RegexOptions.Compiled);8 private static readonly Regex EventKeyReg = new Regex(@"(?<=<EventKey><!\[CDATA\[).*?(?=\]\]></EventKey>)", RegexOptions.Compiled);
1 /// <summary> 2 /// 接受微信消息，如果需要反馈，则调用回复接口进行答复 3 /// </summary> 4 /// <param name="ToUserName">开发者微信号</param> 5 /// <param name="FromUserName">发送方帐号（一个OpenID）</param> 6 /// <param name="CreateTime">消息创建时间 （整型）</param> 7 /// <param name="MsgType">text</param> 8 /// <param name="Content">文本消息内容</param> 9 /// <param name="MsgId">消息id，64位整型</param>10 /// <returns>successful or not</returns>11 [System.Web.Http.AcceptVerbs("POST")]12 [System.Web.Http.ActionName("Api")]13 [ApiExplorerSettings(IgnoreApi = false)]14 public HttpResponseMessage ReceiveMessage()15 {16 var message = Request.Content.ReadAsStringAsync().Result;17 18 var toUserName = GetItemValue(message, ToUserNameReg);19 var fromUserName = GetItemValue(message, FromUserNameReg);20 var createTime = GetItemValue(message, CreateTimeReg);21 var msgType = GetItemValue(message, MsgTypeReg);22 var content = GetItemValue(message, ContentReg);23 var msgId = GetItemValue(message, MsgIdReg);24 var eventStr = GetItemValue(message, EventReg);25 var eventKey = GetItemValue(message, EventKeyReg);26 27 var logStr = string.Format("Message:{8}\n\nToUserName:{0}\nFromUserName:{1}\nCreateTime:{2}\nMsgType:{3}\nContent:{4}\nMsgId:{5}\nEvent:{6}\nEventKey:{7}",28 toUserName, fromUserName, createTime, msgType, content, msgId, eventStr, eventKey, message);29 logger.Debug(logStr);30 31 switch (msgType)32 {33 case "text":34 {35 var returnMessage = Tools.GetCategory(content); // 这块是获取反馈信息的方法，你的和我的应该不一样，所以这块你得修改一下。36 var sendMessage = GetSendMessage(fromUserName, returnMessage, toUserName);37 logger.Debug("MsgId:" + msgId + Environment.NewLine + sendMessage);38 39 return Tools.GetReturn(sendMessage); // 这个函数在上面已经贴出来了，在这块就不在贴了40 }41 case "event":42 {43 if (eventStr == "subscribe") // 关注事件44 {45 var returnMessage = "欢迎关注**账号 [微笑]";46 var sendMessage = GetSendMessage(fromUserName, returnMessage, toUserName);47 return Tools.GetReturn(sendMessage);48 }49 return Tools.GetReturn("error");50 }51 default:52 return Tools.GetReturn("error");53 }54 }
1 /// <summary> 2 /// 获取消息体中正则所能匹配到的内容 3 /// </summary> 4 /// <param name="message">消息内容</param> 5 /// <param name="regex">正则</param> 6 /// <returns>返回正则匹配的所有内容</returns> 7 [ApiExplorerSettings(IgnoreApi = true)] 8 private string GetItemValue(string message, Regex regex) 9 {10 if(regex.IsMatch(message))11 return regex.Match(message).Value;12 return "";13 }
1 /// <summary> 2 /// 发送被动响应消息 3 /// </summary> 4 /// <param name="ToUserName">接收方帐号（收到的OpenID）</param> 5 /// <param name="Content">回复的消息内容（换行：在content中能够换行，微信客户端就支持换行显示）</param> 6 /// <param name="FromUserName">开发者微信号</param> 7 /// <param name="CreateTime">消息创建时间 （整型）</param> 8 /// <param name="MsgType">text</param> 9 /// <returns></returns>10 [System.Web.Http.AcceptVerbs("POST")]11 [System.Web.Http.ActionName("GetSendMessage")]12 [ApiExplorerSettings(IgnoreApi = false)]13 public string GetSendMessage(string ToUserName, string Content, string FromUserName = Developer,14 string MsgType = "text")15 {16 var createTime = Tools.ConvertDateTimeToInt(DateTime.Now);17 18 return19 string.Format(@"<xml><ToUserName><![CDATA[{0}]]></ToUserName><FromUserName><![CDATA[{1}]]></FromUserName><CreateTime>{2}</CreateTime><MsgType><![CDATA[{3}]]></MsgType><Content><![CDATA[{4}]]></Content></xml>", ToUserName, FromUserName, createTime, MsgType, Content);20 }
【相关推荐】
1. 微信公众号平台源码下载
以上就是从源代码中带你解析微信开发的详细内容，更多请关注其它相关文章！