利用第三方的SDK【Senparc.Weixin.MP】来开发属于自己的微信公众号。
此项目的GitHub地址:https://github.com/Andyahui/xgyxsh_WeiXin
这个系列是自己做的一个dome,主要想通过这个练习理清微信开发的基本流程和网站开发的思路,学会在项目实战中学习知识,使自己朝大牛的路上更近一步。
废话不多说--进入主题。
一:开发工具大礼包
微信公众平台开发者API:
微信公众号平台接口调试工具:
Senparc.Weixin.MP的github地址: https://github.com/JeffreySu/WeiXinMPSDK/
Senparc.Weixin.MP的官方博客地址:http://www.cnblogs.com/szw/archive/2013/05/14/weixin-course-index.html
Senparc.Weixin.MP的官方网页地址:http://weixin.senparc.com/QA
二:了解微信通信流程
我们知道只要关注微信公众号,就可以和公众号进行简单的通信;比如公众号发送新闻,用户点击微信公众号菜单得到一系列回复,这些就是简单的通信。
2.1--通信原理:
需要知道客户端发送的请求不是直接到达我们的网站服务器的,而是通过微信服务器转发的,我们的每一次和微信公众号互动都是通过微信的服务器来做中间人(这么叫),这样才能正常的进行一些简单的交互。交互是通过XML文件的格式来进行传递的,具体可以看大神的图。
这个图可以清楚的看到二者的通信过程,利用第三方的SDK可以把 2,4的流程简化,因为它进行了封装,我们需要做的就是 3 处理一些逻辑关系,调用第三方的SDK完成2,4的功能。
微信服务器和网站的通信-----XML <微信开发者资料里面有具体的通信数据交互过程>
2.2--注意事项
- 每条XML信息由大小限制,Content内容不要超过600字;
- 步骤2之后微信服务器有个等待时间:5秒,时间内没有到底4,那么请求就会被关闭。
- 同一个用户关注了两个不同的公众号,他会产生两个不同的OpenId;
- CreateTime使用的是Unix时间,需要进行转换;
- 保证官方API的节点顺序;
- 上面的通信图是单项的,不会从网站向客户端主动推动消息,都是我们在客户端请求才响应得到的;
三:成为开发者
完成微信的开发,我们需要申请微信的公众号(服务号/订阅号)。这两者是有区别的,自己申请的时候就可以看到;由于我们是开发dome,所有就利用微信的测试号来完成就可以,将来部署的时候直接替换就可以。
测试号申请页面: ttp://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login
<直接通过微信扫码登陆就可以免费使用一年,基本的开发接口都有,足以完成常规的开发测试,特别的好。>
我们申请页面成功之后就可以看到具体的测试号信息和接口配置信息,我们需要配置接口的信息;配置接口信息我们需要一个服务器和域名(可以是服务器的IP);
成为开发者的前提是:微信服务器向网站服务器发送GET请求,通过网站服务器将介绍到的随机字符串发送回微信服务器,这样就验证成功就可以成为开发者了。之后的每一次请求就是POST请求。
URL: 指能够接收处理微信服务器发送的GET/POST请求,且地址是存在的,可以通过浏览器访问的。特定到某个处理get请求的页面 .
Token:可由开发者任意填写,用作生成签名(该Token会和接口URL中包含的Token进行比对,从而验证安全性)。
3.1--完成认证
直接新建个空MVC4的项目,引用SDK,添加相应的引用,新建WeixinController控制器,填写下面的代码,直接发布就可以。不需要添加视图,部署到网站服务器上面就可以完成认证,成为开发者。
namespace XGY_WeiXin.Controllers { /// <summary> /// 微信服务器发送的GET/POST请求,从这里在到别的地方去处理相应的逻辑。 /// </summary> public class WeiXinController : Controller { public static readonly string Token = "xgyweixin"; //与微信公众账号后台的Token设置保持一致,区分大小写。 #region GET验证请求 /// <summary> /// 微信后台验证地址(Get请求处理) /// </summary> [HttpGet] [ActionName("Index")] public ActionResult Get(PostModel postModel, string echostr) { if (CheckSignature.Check(postModel.Signature, postModel.Timestamp, postModel.Nonce, Token)) { return Content(echostr); //返回随机字符串则表示验证通过,,官网的有说明。 } else { return Content("failed:" + postModel.Signature + "," + CheckSignature.GetSignature(postModel.Timestamp, postModel.Nonce, Token) + "。" + "如果你在浏览器中看到这句话,说明此地址可以被作为微信公众账号后台的Url,请注意保持Token一致。"); } } #endregion } }
将这样的项目发布到服务器部署,在URL和Token处填写相关的内容,看是否合格;本项目的填写URL:http:www.xgy.llili.cn/Weixin ,URL是具体到相关页面的,这样才会请求到具体的控制器。 Token: xgyweixin ,这个要和自己控制器里面填写的一样。
这样就成为了开发者,接下来就可以进行一系列相关的操作。利用SDK就可以完成微信的相关功能了。
---------------------------------------------------- 明天继续 --------------------------------------------------------------