从源代码中带你解析微信开发
这两天项目需要在微信上面开一个接口,就研究了一下,过程很艰难,结果很理想,下面我就介绍一下微信开发需要注意的地方。 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. 微信公众号平台源码下载 2. 小猪CMS生活通O2O系统v2.0尊享版下载 以上就是从源代码中带你解析微信开发的详细内容,更多请关注php中文网其它相关文章! |