目录

  • 基本原理
  • 公众号申请及配置
  • 验证服务器有效性
  • 微信请求消息类型

基本原理


  • 基本原理如上图:腾讯微信服务器就相当于一个转发服务器,终端(手机、Pad等)发起请求至微信服务器,微信服务器然后将请求转发给我们的开发者服务器,在开发者服务器端可加入我们的业务处理逻辑(如:调用luis API 获取luis定义的Intent和Entity,接入业务处理逻辑),开发者服务器(应用服务器)处理完毕后,将响应数据回发给微信服务器,微信服务器再将具体响应信息回复到微信App终端
  • 通信协议为:HTTP
  • 数据传输格式为:XML

公众号申请及配置


  • 申请地址: https://mp.weixin.qq.com/
  • 登陆系统,在开发->基本配置界面,设置服务器配置信息,包含服务器地址(URL)、Token和EncodingAESKey,如下图
  • 服务器地址即公众号后台提供业务逻辑的入口地址,包括接入验证以及任何其它操作的请求(例如消息的发送、菜单管理、素材管理等)都要从这个地址进入。
  • 接入验证和其它请求的区别就是,接入验证时是get请求,其它时候是post请求
  • Token: 用作生成签名(该Token会和接口URL中包含的Token进行比对,从而验证安全性)
  • EncodingAESKey: 将用作消息体加解密密钥

验证服务器有效性


  • 录入服务器配置信息,点击“提交”按钮后,微信服务器将发送一个http的get请求到刚刚填写的服务器地址,并且携带四个参数
  • 接到请求后,需要做如下三步,若确认此次GET请求来自微信服务器,原样返回echostr参数内容,则接入生效,否则接入失败。

    1. 将token、timestamp、nonce三个参数进行字典序排序   

    2. 将三个参数字符串拼接成一个字符串进行sha1加密   

    3. 开发者获得加密后的字符串可与signature对比,标识该请求来源于微信

  • c#代码实现:1、创建空的web工程  2、添加wx.ashx文件  3、wx.ashx代码如下

    using System;
    using System.Collections.Generic;
    using System.IO;
    using System.Linq;
    using System.Web;
    using System.Web.Security;
    using System.Xml; namespace WXHandler
    {
    /// <summary>
    /// wx 的摘要说明
    /// </summary>
    public class wx : IHttpHandler
    {
    /// <summary>
    ///
    /// </summary>
    /// <param name="context"></param>
    public void ProcessRequest(HttpContext context)
    {
    WXContext wxContext = new WXContext(context); if (wxContext.IsHttpGet) //校验签名,在公众平台填入服务器端配置信息提交之后检验使用
    {
    ValidateUrl(wxContext);
    }
    else
    {
    HandleMsg(wxContext);
    }
    } /// <summary>
    ///
    /// </summary>
    /// <param name="wxContext"></param>
    private void ValidateUrl(WXContext wxContext)
    {
    string echostr = string.Empty;
    bool success = BasicAPI.CheckSignature(wxContext, out echostr);
    if (success)
    {
    HttpContext context = HttpContext.Current;
    context.Response.ContentType = "text/plain";
    context.Response.Write(echostr);
    }
    } /// <summary>
    ///
    /// </summary>
    /// <param name="wxContext"></param>
    public void HandleMsg(WXContext wxContext)
    {
    string msg = WeixinExecutor.Default.Execute(wxContext.WxMsg);
    HttpContext context = HttpContext.Current;
    context.Response.ContentType = "text/plain";
    context.Response.Write(msg);
    } public bool IsReusable
    {
    get
    {
    return false;
    }
    }
    }
    }
  • 检测代码:

    using System;
    using System.Collections.Generic;
    using System.Linq;
    using System.Text;
    using System.Net.Http;
    using System.IO; namespace WXHandler
    {
    /// <summary>
    /// 对应微信API的 "基础支持"
    /// </summary>
    public class BasicAPI
    {
    /// <summary>
    /// 检查签名是否正确:
    /// </summary>
    /// <param name="wxContext"></param>
    /// <param name="echostr"></param>
    /// <returns></returns>
    public static bool CheckSignature(WXContext wxContext, out string echostr)
    {
    var arr = new[] {wxContext.Token,wxContext.Timetamp,wxContext.Nonce}.OrderBy(z => z).ToArray();
    var arrString = string.Join("", arr);
    var sha1 = System.Security.Cryptography.SHA1.Create();
    var sha1Arr = sha1.ComputeHash(Encoding.UTF8.GetBytes(arrString));
    StringBuilder enText = new StringBuilder();
    foreach (var b in sha1Arr)
    {
    enText.AppendFormat("{0:x2}", b);
    }
    echostr = enText.ToString();
    return wxContext.Signature == enText.ToString();
    } }
    }

微信请求消息类型


  • 微信开发文档参见: https://mp.weixin.qq.com/wiki
  • 参见如下代码:包含有文本、语音、图片、位置等信息类型
  • 注意:开通语音识别后,用户每次发送语音给公众号时,微信会在推送的语音消息XML数据包中,增加一个Recongnition字段(注:由于客户端缓存,开发者开启或者关闭语音识别功能,对新关注者立刻生效,对已关注用户需要24小时生效。开发者可以重新关注此帐号进行测试)。
  • 在处理这些消息时,先可查看当前帐号已经获取的权限,位置:开发-->接口权限,默认情况,接收消息中的“接收语音识别结果”选项是关闭的
  • 实现代码如下:
    using System;
    using System.Collections.Generic;
    using System.Linq;
    using System.Web;
    using System.Text;
    using System.Text.RegularExpressions;
    using System.Threading.Tasks;
    using System.Runtime.Serialization;
    using System.IO; namespace WXHandler
    {
    /// <summary>
    ///
    /// </summary>
    public class WeixinExecutor : IWeixinExecutor
    {
    /// <summary>
    ///
    /// </summary>
    public static WeixinExecutor Default
    {
    get { return new WeixinExecutor(); }
    } /// <summary>
    ///
    /// </summary>
    /// <param name="message"></param>
    /// <returns>已经打包成xml的用于回复用户的消息包</returns>
    public string Execute(WeixinMessage message)
    {
    string result = string.Empty;
    var openId = message.Body.FromUserName.Value;
    var myUserName = message.Body.ToUserName.Value;
    switch (message.Type)
    {
    case WeixinMessageType.Text://文字消息
    {
    string userMessage = message.Body.Content.Value;
    var BotMessage = LuisService.Default.PostMessage(userMessage);
    result = ReplayPassiveMessageAPI.RepayText(openId, myUserName, BotMessage);
    }
    break;
    case WeixinMessageType.Image://图片消息
    {
    string imageUrl = message.Body.PicUrl.Value;//图片地址 var msg = ImageService.Default.PostMessage(imageUrl);
    result = ReplayPassiveMessageAPI.RepayText(openId, myUserName, msg);
    }
    break;
    case WeixinMessageType.Voice://语音消息
    {
    var recognition = Convert.ToString(message.Body.Recognition.Value);
    var BotMessage = LuisService.Default.PostMessage(recognition);
    if (BotMessage == LuisInfos.DEFAULT_LUIS)
    BotMessage += string.Format(" 您输入的内容为:{0}", recognition);
    result = ReplayPassiveMessageAPI.RepayText(openId, myUserName, BotMessage);
    }
    break;
    case WeixinMessageType.Location://地理位置消息
    {
    var location_X = message.Body.Location_X.Value.ToString();
    var location_Y = message.Body.Location_Y.Value.ToString(); var BotMessage = LocationService.Default.PostMessage(location_Y, location_X);
    result = ReplayPassiveMessageAPI.RepayText(openId, myUserName, BotMessage);
    }
    break;
    case WeixinMessageType.Link://链接消息
    {
    var title = message.Body.Title.Value.ToString();
    var description = message.Body.Description.Value.ToString();
    var url = message.Body.Url.Value.ToString();
    var msgId = message.Body.MsgId.Value.ToString();
    }
    break;
    default:
    result = ReplayPassiveMessageAPI.RepayText(openId, myUserName,"xxxxxx......");
    break;
    }
    return result;
    }
    }
    }

最新文章

  1. IOS OC数据类型
  2. 学一点Git--20分钟git快速上手
  3. Google Guava学习笔记——基础工具类Splitter的使用
  4. Spark Streaming揭秘 Day3-运行基石(JobScheduler)大揭秘
  5. bitset位图讲解
  6. ssh无密登录
  7. ubuntu10.10和windows双系统启动顺序的修改
  8. 最简单的jdbc操作
  9. readelf相关命令
  10. cocos2dx - 控件扩展之pageview循环显示
  11. PKUWC 2017 Day 2 简要题解
  12. 小程序上传wx.uploadFile - 小程序请假
  13. mysql原理~undo
  14. vue中使用第三方UI库的移动端rem适配方案
  15. ES6简介之let和const命令解说
  16. auto
  17. 牛客网-《剑指offer》-用两个栈实现队列
  18. poj3349(hash table)
  19. C10K——千万级并发实现的秘密:内核不是解决方案,而是问题所在!(转)
  20. centos 安装cloud foundry CLI

热门文章

  1. Ubuntu12.10无法安装openssh-server[已解决]
  2. c++ 正則表達式
  3. JSON解析之Json-lib
  4. CSS3自适配手机屏幕[转]
  5. HTML 5 在Web SQL 使用演示样本
  6. JavaScript里的依赖注入
  7. 写入与导出excel
  8. probuf了解
  9. 【转】Objective-C并发编程:API和挑战
  10. 企业架构研究总结(32)——TOGAF架构内容框架之架构交付物