[转载][原创][下载]Senparc.Weixin.MP-微信公众平台SDK(C#) – SZW – 博客园.
因为正在计划做一个微信机器人,需要用ASP.NET,找了一下只有PHP的SDK,没有C#的,于是动手写了一个,基本功能已经完成。
微信公众平台地址:http://mp.weixin.qq.com
Senparc.Weixin.MP官网地址:http://weixin.senparc.com
用微信扫描下面二维码,添加测试账号为好友(添加后发送文本、位置、图片信息,测试反馈效果):
注意:开始开发之前需要到上面申请一个公众账号,并开启“关键词自动回复 => 公众平台消息接口”,根据提示设置token等信息。
Senparc.Weixin.MP所有项目文件如下:
Senparc.Weixin.MP几个关键类介绍如下:
- Entities/Request*.cs 用于接收微信平台自动发送到服务器的实体(发送过来的是XML),包括文本、位置、图片三类
- Entities/Response*.cs 用于反馈给发送人的信息实体(最终会转成XML),包括文本、新闻(图文)两类
- Helpers/EntityHelper.cs 用于实体和XML之间的转换(由于其中有许多需要特殊处理的字段和类型,这里不能简单用XML序列化)
- Helpers/MsgTypeHelper.cs 用于获取消息类型
- CheckSignature.cs 验证请求合法性类
- Enums.cs 各种枚举
- RequestMessageFactory.cs 用于自动生成不同Request类型的实体,并作必要的数据填充
Senparc.Weixin.MP几个关键类及重要方法(按一般使用过程排序)
- 生成验证字符串:Senparc.Weixin.MP.CheckSignature.GetSignature(string timestamp, string nonce, string token = null),返回根据微信平台提供的数据,SHA1加密后的验证字符串(注意token必须跟公众平台的设置一直)
- 验证请求:Senparc.Weixin.MP.CheckSignature.Check(string signature, string timestamp, string nonce, string token = null),验证请求是否合法
- 获取请求实体:var requestMessage = Senparc.Weixin.MP.RequestMessageFactory.GetRequestEntity(XDocument doc); 根据不同请求的类型,自动生成可用于操作的实体(doc只需要用XDocument.Parse(xmlString)就能生 成),requestMessage.MsgType就是请求枚举类型。
- 进行判断及各类操作。
- 根据需要,创建响应类型的实体,如:var responseMessage = ResponseMessageBase.CreateFromRequestMessage(requestMessage, ResponseMsgType.Text) as ResponseMessageText; 即可返回文本类型信息。
- 由于目前微信只接受XML的返回数据,所以在返回之前还需要做一次转换:XDocument responseDoc = Senparc.Weixin.MP.Helpers.EntityHelper.ConvertEntityToXml(responseMessage); var xmlString = responseDoc.ToString();
- 至此整个微信公众账号的自动响应过程结束。
所有Senparc.Weixin.MP源代码及示例代码已开源(示例是ASP.NET MVC 4,.NET 4.0,为了提高兼容性,Senparc.Weixin.MP源代码使用.NET 3.5):
https://github.com/JeffreySu/WeiXinMPSDK
(包含三个文件夹:Senparc.Weixin.MP、Senparc.Weixin.MP.BuildOutPut、Senparc.Weixin.MP.Sample,分别对应Senparc.Weixin.MP.dll源代码项目、Senparc.Weixin.MP.dll输出目录、Web示例,Web示例建议放到公网测试,让公众平台自动发送)
目前SDK还在测试中,欢迎大家提出宝贵意见!
新浪微博:@苏震巍 QQ:498977166
http://szw.cnblogs.com/
研究、探讨ASP.NET
转载请注明出处和作者,谢谢!