前言
作为中国 C# 开源项目中 Watch/Star/Fork 最高的项目之一,Senparc.Weixin SDK 凝聚了盛派微信团队持续7年的付出,和大量开发者的无私贡献,以及数万开发者的使用与反馈。为了纪念 Senparc.Weixin SDK 项目突破 5000 Stars 这个小小的里程碑,盛派微信团队为大家准备了一份特殊福利:微信接口动态 WebApi 系统(以下简称“系统”),在此系统中,您可以使用 WebApi 调用 Senparc.Weixin SDK 已经集成的微信高级接口,用于各项接口测试,或完成紧急情况下的微信功能操作。
订阅APP
为了确保安全性,此系统已经集成到 NeuChar 系统中作为 APP 进行订阅,然后进行自动授权访问,因此您需要首先打开 NeuChar 首页:https://www.neuchar.com,点击右上方【登录 NeuChar 管理中心】:
网页会跳转到 https://weixin.senparc.com 域名下进行统一登录,如果您已经注册过,可以使用微信扫描二维码登陆,如果没有,请进行注册,并在注册成功后,再次登陆 https://www.neuchar.com:
登陆成功后,进入 NeuChar 后台:
如果您是新注册用户,此时如果您点击左侧,会看到系统已经为您添加了一个微信管理账号(也叫【NeuChar Cell 账号】),您可以用它进行微信菜单设置等操作。这一步只是对 NeuChar Cell 做一个介绍,可以略过。希望一进步了解的朋友可以阅读《NeuChar 平台使用及开发教程 索引》。
点击左侧菜单按钮,出现【应用商店】中的 APP 列表:
在【应用商店】中选择【微信 API Swagger 文档】应用:
选择需要订阅的【NeuChar Cell 账号】,点击【立即订阅】:
因为目前此 APP 限免,您不需要支付任何费用,点击【确定按钮】,完成订阅(您也可以选择多个月的订阅时间):
您会看到一个授权通知界面:
系统会为您自动跳到应用首页:
可以看到,这个站点使用了 SCF 作为模板,今后我们将以 SCF 为模板为大家献上开源的 NeuChar App Sample,大家可以在此 Sample 基础上开发类似的 NeuChar App。
本系统所使用的动态 API 核心也将在未来集成到 SCF ,开源给大家。
使用 Swagger 微信 API
点击顶部【API 文档】按钮,稍等片刻,即可看到完整的已被 Senparc.Weixin SDK 集成的接口文档,并且已经自动按照接口分类进行了分组,点击任意一个分组标签,就可以展开下面所有的接口:
为了能够使用高级接口,我们首先需要调用【CommonApi】下的 【GetToken】,以获取 AccessToken:
点击按钮,自动出现接口参数:
注意:如果您使用的是测试号(https://mp.weixin.qq.com/debug/cgi-bin/sandboxinfo?action=showinfo&t=sandbox/index),不需要进行任何设置,如果您使用的是正式的公众号,需要在微信后台添加IP白名单:121.201.3.83。
点击【Execute】按钮,即可看到微信结果:
上图红框中已经获取到 access_token,将后面字符串中的值复制出来,以备后用。
注意:如果没有完成之前从 NeuChar 的授权登录过程,系统将拒绝服务,返回错误信息:
有了 AccessToken,我们就可以用其调用任意接口,当然,如果 AccessToken 错误,则可能返回 500 错误消息。
例如我们使用Url转短连接的接口:
可以看到接口访问成功,把 https://www.neuchar.com 转成了 https://w.url.cn/s/A8qKZEi,大家也可以测试一下。
除了单个 AccessToken 的接口,我们还可以调用多参数的接口,例如尝试一下客服接口:
如上图输入 AccessToken 以及本人的 OpenId,和想要发送的客服消息,微信客户端立即响应到了这条请求。
可能您也已经发现,Swagger 页面的右上角,有一个下拉菜单,其中提供了微信公众号、小程序、开放平台、企业号的接口筛选,且每个选项右侧标有当前系统所使用的微信模块的版本号,方便大家使用!
PS:由于安全问题,微信支付暂时未集成到系统中。
特别说明:在所有参数正确的情况下(包括 AccessToken),调用接口如果出现 500 错误,应当首先排除是否为 40001 错误,也就是没有此接口的权限,如果您确定权限无误,可以加群让管理员为您排查错误。NeuChar 和 SCF 分别有专用QQ群可以加,也欢迎进群交流相关技术:
- NeuChar 技术交流群:618605800
- SCF 技术交流群:147054579
原文地址:https://www.cnblogs.com/szw/p/wechat-5000-gift.html