随笔-129  评论-1324  文章-1 

[原创][下载]Senparc.Weixin.MP-微信公众平台SDK(C#) - 已支持微信6.x API

    因为正在计划做一个微信机器人,需要用ASP.NET,找了一下只有PHP的SDK,没有C#的,于是动手写了一个,已经全面支持微信6.x所有接口,包括多客服、卡券、微信支付等。

  1.     微信公众平台地址:http://mp.weixin.qq.com
  2.     Senparc.Weixin SDK 官网地址:http://weixin.senparc.com
  3.     所有源代码(SDK+示例): https://github.com/JeffreySu/WeiXinMPSDK(新版本已发布,可以在github中查看最新的代码和教程)
  4.     在线示例(开源):http://sdk.weixin.senparc.com
  5.     微信技术交流社区:http://weixin.senparc.com/QA
  6.     chm帮助文档下载:http://sdk.weixin.senparc.com/Document
  7.     微信开发资源汇总:https://github.com/JeffreySu/WeixinResource

    目前已经支持微信6.x所有API(主要是自定义菜单),并且我为大家准备了两个非常好用的在线工具(都已在源代码中开源):

技术交流QQ群:

  • 1群:300313885 (2000人已满)
  • 2群:293958349 (1000人未满)Senparc.Weixin.MPSDK 2群
  • 3群:342319110 (2000人已满)
  • 4群:372212092 (1000人已满)
  • 5群:377815480 (500人已满)
  • 6群:425898825 (1000人已满)
  • 7群:482942254 (500人已满)
  • 8群:106230270 (500人已满)
  • 9群:539061281 (500人已满)
  • 10群(Redis / Memcached 分布式缓存群): 246860933  Senparc.Weixin.Cache SDK 10群 
  • 11群:553198593 (500人已满)
  • 12群(微信小程序):(1000人)108830388 Senparc微信小程序 12群 
  • 13群(微信开放平台):183424136 Senparc.Weixin SDK 开放平台(Open) 13群

 

    用微信扫描下面二维码,关注官方公众号(添加后可发送文本、位置、图片信息,以及点击菜单,测试部分功能效果):

    

    注意:开始开发之前需要到上面申请一个公众账号,并开启“关键词自动回复 => 公众平台消息接口”,根据提示设置token等信息。

    Senparc.Weixin.MP所有项目文件如下:


(项目已更新,具体文件请到https://github.com/JeffreySu/WeiXinMPSDK查看或同步最新代码)

    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几个关键类及重要方法(按一般使用过程排序,注意很多地方已经升级到更简洁的方法,请参考最新的代码:https://github.com/JeffreySu/WeiXinMPSDK

  1. 生成验证字符串:Senparc.Weixin.MP.CheckSignature.GetSignature(string timestamp, string nonce, string token = null),返回根据微信平台提供的数据,SHA1加密后的验证字符串(注意token必须跟公众平台的设置一直)
  2. 验证请求:Senparc.Weixin.MP.CheckSignature.Check(string signature, string timestamp, string nonce, string token = null),验证请求是否合法
  3. 获取请求实体:var requestMessage = Senparc.Weixin.MP.RequestMessageFactory.GetRequestEntity(XDocument doc); 根据不同请求的类型,自动生成可用于操作的实体(doc只需要用XDocument.Parse(xmlString)就能生成),requestMessage.MsgType就是请求枚举类型。
  4. 进行判断及各类操作。
  5. 根据需要,创建响应类型的实体,如:var responseMessage = ResponseMessageBase.CreateFromRequestMessage(requestMessage, ResponseMsgType.Text) as ResponseMessageText; 即可返回文本类型信息。
    注:v0.6版本以后,此方法可以简写为:var responseMessage = CreateResponseMessage<ResponseMessageText>();
  6. 由于目前微信只接受XML的返回数据,所以在返回之前还需要做一次转换:XDocument responseDoc = Senparc.Weixin.MP.Helpers.EntityHelper.ConvertEntityToXml(responseMessage); var xmlString = responseDoc.ToString();
  7. 至此整个微信公众账号的自动响应过程结束。

    

    所有Senparc.Weixin.MP源代码及示例代码已开源(示例是ASP.NET MVC 4,.NET 4.0,Senparc.Weixin.MP源代码最低支持.NET 4.0,其中.NET 4.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还在测试中,欢迎大家提出宝贵意见!

 

补充:

    关于直接使用Senparc.Weixin.MP.Sample部署到服务器上进行测试的朋友,有几点需要注意一下:

  1. 进入微信公众账号后台后,依次进入 高级功能 > 开发模式 > 成为开发者 ,编辑接口配置信息,其中Url中需要填写默认端口(80)的Url,如http://weixin.senparc.com/weixin (注意后面的/weixin一定要加,这是用于验证的一个Controller地址)
  2. 为了确保安全,在上述接口配置信息中的Token最好输入一个复杂一些的字符串,并且在Senparc.Weixin.MP.Sample/Controllers/WeixinController.cs中修改Token使之匹配,如:

 

关于Senparc.Weixin.MP.Test单元测试项目所有Senparc.Weixin.MP核心代码都已通过单元测试。没有外网部署条件的朋友也可以使用Senparc.Weixin.MP.Test项目提供的单元测试进行测试,这些测试同样适用于微信还没有正式发布、无法实际测试的功能,如消息推送:


截图对应测试版本:v0.3.1

 

微信开发教程(Senparc.Weixin.MP SDK): http://www.cnblogs.com/szw/archive/2013/05/14/weixin-course-index.html

 

 

Senparc.Weixin.MP SDK正在筹备出版官方图书,您可以使用微信“扫一扫”下方二维码参与众筹:

 

 

 

(本书为微信公众号,后续还会有企业号、开放平台等系列图书)

 

 

posted on 2013-01-13 00:34 SZW 阅读(...) 评论(...) 编辑 收藏