服务器之家

服务器之家 > 正文

C#开发微信门户及应用(1) 微信接口使用

时间:2022-01-07 13:56     来源/作者:伍华聪

微信应用如火如荼,很多公司都希望搭上信息快车,这个是一个商机,也是一个技术的方向,因此,有空研究下、学习下微信的相关开发,也就成为日常计划的重要事情之一了。本系列文章希望从一个循序渐进的角度上,全面介绍微信的相关开发过程和相关经验总结,希望给大家了解一下相关的开发历程。本随笔主要针对微信开发过程的前期准备和一些初始的工作的介绍。

在写下本文的之前一周时间里,我主要就是参考一些介绍文章以及微信公众平台的相关接口说明,并结合c#的代码开发,整理了自己公司的门户界面,实现了微信工作号的初步用户交互和信息展示工作,随着工作的进一步开展,越来越多的功能可能加入,并希望从应用角度上扩展微信的接口,从而实现我对微信接口的技术探秘和了解过程。

1、微信账号

要开发使用微信的平台api,就需要到微信的公众平台(https://mp.weixin.qq.com/)去注册,拥有一个服务号或者订阅号,服务号主要面对企业和组织,订阅号主要面向组织和个人,他们之间有一定的差异,根据不同的需要自己申请对应的账号即可。

为了使用一些高级的接口,你可能需要拥有服务号和高级的认证。账号注册过程,需要下载一个申请表格,打印并盖公章,另外还需要申请人拿着身份证拍照(有点怪异,呵呵),然后上传到服务器进行审核,一般很快就能获取批复。

我以公司名义申请了服务号,账号注册后,会在主界面上显示你的相关信息,另外给你申请一个二维码的东西,扫描二维码即可进入公司的微信关注确认对话框,非常方便。如下就是我申请后的公司账号二维码,可以直接使用扫描。

C#开发微信门户及应用(1) 微信接口使用

2、微信菜单定义

微信有两种方式的菜单定义,一种是编辑模式,一种是开发模式,两者互斥,也就是说,一旦我们采用了开发模式,就不能使用编辑模式了,反过来也一样。编辑下的菜单,其实也是可以管理的,但是微信不支持,觉得很不爽。

一般情况下,如果我们刚刚申请了微信号码,可以使用编辑菜单测试一下,根据说明编辑一些菜单试试。虽然微信说24小时内更新,不过一般很快,最快可能一两分钟就更新了,感觉还是不错的。

使用开发者模式,你需要根据微信的要求,在服务器上放置一个页面链接,使用c#开发的,可以采用***.ashx的命名方式,使用asp.net的一般处理程序即可,不需要使用普通的页面。

使用开发模式的菜单,也就是可以调用微信api进行菜单创建的工作,对于调用微信的api(微信有很多api可以调用),我们需要知道,有几个参数的重要性,所以在开发模式打开的时候,会给你列出这些参数,如下所示。

C#开发微信门户及应用(1) 微信接口使用

3、接入微信的链接处理

上面说了,你申请开发模式对菜单或者对其他api的调用,你需要顺利通过接入微信的测试,也就是确认你填写的链接存在并能顺利经过微信的回调测试。微信提供了一个php的页面处理例子,如果我们是c#开发的呢,可以搜一下就会得到答案,我的处理方式如下所示。

创建一个一般处理程序,然后在其处理页面里面增加一个处理逻辑,如果是非post方式的内容,就是表示微信进行的get测试,你需要增加一些处理逻辑,把它给你的内容传回去即可,如果是post方式的,就是微信服务器对接口消息的请求操作了,后面介绍。

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
/// <summary>
/// 微信接口。统一接收并处理信息的入口。
/// </summary>
public class wxapi : ihttphandler
{
public void processrequest(httpcontext context)
{
 string poststring = string.empty;
 if (httpcontext.current.request.httpmethod.toupper() == "post")
 {
 using (stream stream = httpcontext.current.request.inputstream)
 {
  byte[] postbytes = new byte[stream.length];
  stream.read(postbytes, 0, (int32)stream.length);
  poststring = encoding.utf8.getstring(postbytes);
 }
 
 if (!string.isnullorempty(poststring))
 {
  execute(poststring);
 }
 }
 else
 {
 auth(); //微信接入的测试
 }
}

一般来说,auth函数里面,就是要对相关的参数进行获取,然后进行处理返回给微信服务器。

?
1
2
3
4
5
6
string token = "****";//你申请的时候填写的token
 
string echostring = httpcontext.current.request.querystring["echostr"];
string signature = httpcontext.current.request.querystring["signature"];
string timestamp = httpcontext.current.request.querystring["timestamp"];
string nonce = httpcontext.current.request.querystring["nonce"];

完整的author函数代码如下所示,其中我把业务逻辑进行进一步抽取到了一个新的类里面,方便业务逻辑的管理。

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
/// <summary>
/// 成为开发者的第一步,验证并相应服务器的数据
/// </summary>
private void auth()
{
 string token = configurationmanager.appsettings["weixintoken"];//从配置文件获取token
 if (string.isnullorempty(token))
 {
 logtexthelper.error(string.format("weixintoken 配置项没有配置!"));
 }
 
 string echostring = httpcontext.current.request.querystring["echostr"];
 string signature = httpcontext.current.request.querystring["signature"];
 string timestamp = httpcontext.current.request.querystring["timestamp"];
 string nonce = httpcontext.current.request.querystring["nonce"];
 
 if (new basicapi().checksignature(token, signature, timestamp, nonce))
 {
 if (!string.isnullorempty(echostring))
 {
  httpcontext.current.response.write(echostring);
  httpcontext.current.response.end();
 }
 }
}

而对微信参数的签名并返回的操作checksignature,代码如下所示

?
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
/// <summary>
/// 验证微信签名
/// </summary>
public bool checksignature(string token, string signature, string timestamp, string nonce)
{
 string[] arrtmp = { token, timestamp, nonce };
 
 array.sort(arrtmp);
 string tmpstr = string.join("", arrtmp);
 
 tmpstr = formsauthentication.hashpasswordforstoringinconfigfile(tmpstr, "sha1");
 tmpstr = tmpstr.tolower();
 
 if (tmpstr == signature)
 {
 return true;
 }
 else
 {
 return false;
 }
}

 4、使用开发方式创建菜单

一旦你顺利通过微信的认证,那么它就让你以开发方式调用它的api,并且可以随意创建你的菜单了。

创建菜单的方式,你可以通过下面的位置进入到他的api处理界面里面。

C#开发微信门户及应用(1) 微信接口使用

进入后,你会发现微信把很多消息的处理,分门别类放到不同的分类里面了。

C#开发微信门户及应用(1) 微信接口使用

其实我们现在初步要做的就是如何看看,使用代码方式调用创建菜单,进入菜单的api调试界面里面。

C#开发微信门户及应用(1) 微信接口使用

你会发现里面还需要输入一个access_token的东西,这个是一个会话身份认证,因此你还需要到接口里面去找这个如何创建的。下面图中的两个红色部分,就是我们开始的时候,微信提示我们“开发者凭据”的两个关键参数。

C#开发微信门户及应用(1) 微信接口使用

弄完这些,你就可以根据获得的access_token进行菜单的创建工作了,根据菜单的定义,它分为几类,可以分为url方式(view),事件方式(click)。

click:用户点击click类型按钮后,微信服务器会通过消息接口推送消息类型为event 的结构给开发者(参考消息接口指南),并且带上按钮中开发者填写的key值,开发者可以通过自定义的key值与用户进行交互;
view:用户点击view类型按钮后,微信客户端将会打开开发者在按钮中填写的url值(即网页链接),达到打开网页的目的,建议与网页授权获取用户基本信息接口结合,获得用户的登入个人信息。

5、我创建的菜单案例

在随笔的开始,我公布了一个二维码,一旦使用微信扫一扫,进行关注服务号后,那么就可以看到我自己创建的菜单了。主菜单一般最多三列,每个主菜单还可以有子菜单,他们的文字都有所限制的。

我们来看看我公司的微信门户菜单,看起来是不是很酷呢。

C#开发微信门户及应用(1) 微信接口使用

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持服务器之家。

原文链接:http://wuhuacong.cnblogs.com/p/3613826.html

标签:

相关文章

热门资讯

蜘蛛侠3英雄无归3正片免费播放 蜘蛛侠3在线观看免费高清完整
蜘蛛侠3英雄无归3正片免费播放 蜘蛛侠3在线观看免费高清完整 2021-08-24
yue是什么意思 网络流行语yue了是什么梗
yue是什么意思 网络流行语yue了是什么梗 2020-10-11
背刺什么意思 网络词语背刺是什么梗
背刺什么意思 网络词语背刺是什么梗 2020-05-22
2020微信伤感网名听哭了 让对方看到心疼的伤感网名大全
2020微信伤感网名听哭了 让对方看到心疼的伤感网名大全 2019-12-26
2021年耽改剧名单 2021要播出的59部耽改剧列表
2021年耽改剧名单 2021要播出的59部耽改剧列表 2021-03-05
返回顶部