背景
最近开发微信公众号相关接口,在这里记录下微信公众号相关各项功能的实现。
先决条件
1、一台可部署web服务的服务器或者云平台(本地可以搞个花生壳域名)。
2、一个可以正常使用的微信公众账号,开始的时候使用它的测试号。
3、Visual Studio 2019
开发步骤
采用Web API项目作为微信公众号后台服务。
1、成为微信公众号开发者
这一步很简单,只要在微信公众号后台的开发者中心同意协议即可,同意之后页面如下:
2、服务器配置
登录微信公众平台官网后,在公众平台后台管理页面 - 开发者中心页,点击“修改配置”按钮,填写服务器地址(URL)、Token和EncodingAESKey,其中URL是开发者用来接收微信消息和事件的接口URL。Token可由开发者可以任意填写,用作生成签名(该Token会和接口URL中包含的Token进行比对,从而验证安全性)。EncodingAESKey由开发者手动填写或随机生成,将用作消息体加解密密钥。同时,开发者可选择消息加解密方式:明文模式、兼容模式和安全模式。模式的选择与服务器配置在提交后都会立即生效,请开发者谨慎填写及选择。加解密方式的默认状态为明文模式,选择兼容模式和安全模式需要提前配置好相关加解密代码。
3、回调代码实现
[HttpGet][ActionName("CallBack")]public HttpResponseMessage WetChatVerify(HttpRequestMessage content){string echostr = (from kvp in content.GetQueryNameValuePairs()where kvp.Key == "echostr"select kvp.Value).FirstOrDefault();var postModel = GetPostModel(content);if (CheckSignature.Check(postModel.Signature, postModel.Timestamp, postModel.Nonce, Token)){var result = new StringContent(echostr, UTF8Encoding.UTF8, "application/x-www-form-urlencoded");var response = new HttpResponseMessage { Content = result };return response; //返回随机字符串则表示验证通过}else{var result = new StringContent("failed:" + postModel.Signature + "," + Senparc.Weixin.MP.CheckSignature.GetSignature(postModel.Timestamp, postModel.Nonce, Token) + "。如果您在浏览器中看到这条信息,表明此Url可以填入微信后台。", UTF8Encoding.UTF8, "application/x-www-form-urlencoded");var response = new HttpResponseMessage { Content = result };return response;}}
这里我们使用Senparc.Weixin SDK。
这样在我们填入我们服务器端API地址后,就能够顺利搞定服务器配置,绑定微信公众号后台了。
总结
成为开发者后,用户每次向公众号发送消息、或者产生自定义菜单、或产生微信支付订单等情况时,开发者填写的服务器配置URL将得到微信服务器推送过来的消息和事件,开发者可以依据自身业务逻辑进行响应,如回复消息。