概述

最简洁最易于使用的微信Sdk,包括公众号Sdk、小程序Sdk、企业微信Sdk等,以及Abp VNext集成。

名称 Nuget
Magicodes.Wx.PublicAccount.Sdk
Magicodes.Wx.PublicAccount.Sdk.AspNet
Magicodes.Wx.PublicAccount.Sdk.Abp

如何贡献?

如何快速封装一个微信接口?(30秒编写一个微信Api,欢迎多多PR)

如何快速定义一个微信上传文件的接口?

RoadMap

公众号

  • 全局

    • 接口结果基类(ApiResultBase

      • 全局返回码(ReturnCodes
      • 是否成功返回(IsSuccess
      • 获取异常友好提示消息(GetFriendlyMessage
    • Access Token获取(ITokenApi

    • Token管理器(ITokenManager

    • Access Token API请求筛选器(AccessTokenApiFilter

      • IWxApiBase
      • IWxApiWithAccessTokenFilter(启用AccessTokenApiFilter
    • 从配置文件获取公众号配置

        "Wx": {
      "PublicAccount": {
      "AppId": "",
      "AppSecret": ""
      }
      }
    • 函数注入(WxFuncs

      • GetWeChatOptions【获取公众号配置】
      • GetAccessTokenByAppId【根据AppId获取Access Token】
      • CacheAccessToken【缓存Access Token】
    • 异常(WxSdkException

    • Abp Vnext集成(Magicodes.Wx.PublicAccount.Sdk.Abp

      • WxPublicAccountSdkModule(默认已实现IDistributedCache)
    • Magicodes.Wx.PublicAccount.Sdk.AspNet模块

      • 事件消息控制器(WxEventController
      • 服务器事件消息处理器(IWxEventsHandler
      • 公众号网页开发基类(WxPublicAccountControllerBase
      • 公众号授权筛选器(WxPublicAccountOAuthFilter
  • 基础消息能力

    • 服务器事件消息

      • 服务器事件消息配置接入以及验证
      • 事件推送
        • 关注事件:FromSubscribeEvent
        • 取消关注事件:FromUnsubscribeEvent
        • 扫码事件:FromScanEvent
        • 地理位置选择器事件:FromLocationEvent
        • 点击事件:FromClickEvent
        • 点击菜单链接跳转事件:FromViewEvent
        • 模板消息推送完成事件:FromTemplateSendJobFinishEvent
        • 点击菜单跳转小程序事件:FromViewMiniprogramEvent
      • 基础消息
        • 文本消息:FromTextMessage
        • 图片消息:FromImageMessage
        • 语音消息:FromVoiceMessage
        • 视频消息:FromVideoMessage
        • 小视频消息:FromShortVideoMessage
        • 地理位置消息:FromLocationMessage
        • 链接消息:FromLinkMessage
      • 被动消息回复
        • 回复文本消息:ToTextMessage
        • 回复图片消息:ToImageMessage
        • 回复语音消息:ToVoiceMessage
        • 回复视频消息:ToVideoMessage
        • 回复音乐消息:ToMusicMessage
        • 回复图文消息:ToNewsMessage
        • 回复空消息(不回复):ToNullMessage
    • 群发接口

      • 上传图文消息内的图片获取URL【订阅号与服务号认证后均可用】(IMediaApi>>UploadImageAsync
      • 上传图文消息素材【订阅号与服务号认证后均可用】
      • 根据标签进行群发【订阅号与服务号认证后均可用】
      • 根据OpenID列表群发【订阅号不可用,服务号认证后可用】
      • 删除群发【订阅号与服务号认证后均可用】
      • 预览接口【订阅号与服务号认证后均可用】
      • 查询群发消息发送状态【订阅号与服务号认证后均可用】
    • api调用次数进行清零

    • 获取公众号当前使用的自动回复规则

    • 公众号一次性订阅消息

    • 模板消息(ITemplateApi

  • 自定义菜单(IMenuApi

    • 创建接口(CreateAsync
    • 查询接口(GetAsync
    • 删除接口(DeleteAsync
    • 个性化菜单接口
    • 获取自定义菜单配置
  • 订阅通知

    • 选用模板
    • 删除模板
    • 获取公众号类目
    • 获取模板中的关键词
    • 获取所属类目的公共模板
    • 获取私有模板列表
    • 发送订阅通知
  • 客服消息

    • 客服管理(IKfAccountApi

      • 获取客服基本信息(GetKFListAsync
      • 添加客服账号(AddAsync
      • 邀请绑定客服账号(InviteWorkerAsync
      • 设置客服信息(UpdateAsync
      • 上传客服头像(UploadHeadimg
      • 删除客服账号(DelAsync
      • 获取在线客服接待会话数(GetOnlineKFListAsync
  • 微信网页开发

    • 网页授权

      • 获取授权链接(WxHelper >> GetAuthorizeUrl
      • 通过code换取网页授权access_token(IOauth2Api >> GetAccessTokenAsync)
      • 刷新access_token(IOauth2Api >> RefreshTokenAsync)
      • 拉取用户信息(ISnsApi >> GetUserInfoAsync
      • 检验授权凭证(access_token)是否有效(ISnsApi >> AuthAsync
  • 对话能力

    • 顾问管理

      • 添加顾问
      • 获取顾问信息
      • 修改顾问信息
      • 删除顾问
      • 获取服务号顾问列表
      • 生产顾问二维码
      • 扫顾问二维码后的事件推送
      • 获取顾问聊天记录
      • 设置快捷回复与关注自动回复
      • 获取快捷回复与关注自动回复
      • 设置离线自动回复与敏感词
      • 获取离线自动回复与敏感词
      • 新建顾问分组
      • 获取顾问分组列表
      • 获取顾问分组信息
      • 分组内添加顾问
      • 分组内删除顾问
      • 获取顾问所在分组
      • 删除顾问分组
    • 客户管理
      • 为顾问分配客户
      • 为顾问移除客户
      • 获取顾问的客户列表
      • 为客户更好顾问
      • 修改客户昵称
      • 查询客户所属顾问
      • 查询指定顾问和客户的关系
    • 标签管理
      • 新建标签类型
      • 删除标签类型
      • 为标签添加可选值
      • 获取标签和可选值
      • 为客户设置标签
      • 查询客户标签
      • 根据标签值刷选客户
      • 删除客户标签
      • 设置自定义客户信息
      • 获取自定义客户信息
    • 素材管理
      • 添加小程序卡片素材
      • 查询小程序卡片素材
      • 删除 小程序卡片素材
      • 添加图片素材
      • 查询图片素材
      • 删除图片素材
      • 添加文字素材
      • 查询文字素材
      • 删除文字素材
    • 群发任务管理
      • 添加群发任务
      • 获取群发任务列表
      • 获取指定群发任务信息
      • 修改群发任务
      • 取消群发任务
  • 素材管理(IMediaApi

    • 新增临时素材(UploadAsync
    • 获取临时素材
    • 新增永久素材
    • 获取永久素材
    • 删除永久素材
    • 修改永久图文素材
    • 获取素材总数
    • 获取素材列表
  • 图文消息留言管理

  • 用户管理

    • 用户标签管理
    • 设置用户备注名
    • 获取用户基本信息(UnionID机制)
    • 获取用户列表
    • 获取用户地理位置
    • 黑名单管理
  • 账号管理

    • 生产带参数的二维码
    • 长链接转短链接接口
    • 短key托管
    • 微信认证时间推送
  • 数据统计

    • 用户分析
    • 图文分析
    • 消息分析
    • 广告分析
      • 分广告位数据
      • 返佣商品数据
      • 结算收入数据
    • 接口分析
  • 微信卡券

    • 微信卡券接口
    • 更新日志
    • 创建卡券
    • 投放卡券
    • 核销卡券
    • 管理卡券
    • 卡券事件推送
    • 卡券-小程序打通
    • 微信礼品卡
    • 会员卡专区
      • 玩法介绍
      • 创建会员卡
      • 管理会员卡
    • 特殊票券
    • 卡券错误码
    • 第三方开发者模式
  • 微信门店

    • 微信门店接口
    • 微信门店小程序接口
  • 微信小店

  • 智能接口

    • 语义理解
    • AI开放接口
    • OCR识别
    • 图像处理
  • 一物一码

  • 微信发票

  • 微信非税缴费

小程序

  • 登录
  • 用户信息
  • ...

快速上手

本Sdk上手非常简单,参考教程如下所示。

1)安装包

Install-Package Magicodes.Wx.PublicAccount.Sdk.AspNet

推荐使用此包,亦可使用Magicodes.Wx.PublicAccount.Sdk来进行更多的自定义配置。

2)基础配置

  • 配置文件配置

公众号的参考配置如下所示,请在appsettings.json文件中进行配置:

  "Wx": {
"PublicAccount": {
"AppId": "",
"AppSecret": ""
}
  • 通过代码配置

参考代码如下所示:

        app.UseMagicodesWeChatSdk(setup =>
{
setup.GetWeChatOptions = () =>
{
//配置
return new WxPublicAccountOption()
{
AppId = "",
AppSecret = ""
};
};
});

3)配置Sdk

参考代码如下所示:

        public void ConfigureServices(IServiceCollection services)
{
//添加公众号Sdk集成
services.AddMPublicAccountSdk()
//使用内存缓存
.AddDistributedMemoryCache();
} public void Configure(IApplicationBuilder app)
{
//配置公众号Sdk
app.UseMPublicAccountSdk()
//使用分布式缓存缓存Access Token
.UseWxDistributedCacheForAccessToken();
}

4)调用Api

接下来就简单了,通过依赖注入的方式注入相关Api,比如构造函数注入:

    public HomeController(IMenuApi menuApi)
{
_menuApi = menuApi;
}

然后就可以使用了,如下面代码:

        var result = await _menuApi.CreateAsync(new CreateMenuInput()
{
Button = new List<MenuButtonBase>()
{
new ClickButton()
{
Name = "今日歌曲",
Key = "V1001_TODAY_MUSIC"
},
new SubMenuButton()
{
Name = "菜单",
SubButtons = new List<MenuButtonBase>()
{
new ViewButton()
{
Name = "搜索",
Url = "http://www.soso.com/"
},
//需关联小程序后
//new MiniprogramButton()
//{
// Name = "wxa",
// Url = "http://mp.weixin.qq.com",
// AppId = "wx286b93c14bbf93aa",
// Pagepath = "pages/lunar/index"
//},
new ClickButton()
{
Name = "赞一下我们",
Key = "V1001_GOOD"
}
}
}
}
});
result.EnsureSuccess();

微信服务器事件、消息处理和被动消息回复

如何处理微信服务器事件、消息,步骤如下所示:

1)配置Sdk

nuget包的安装和公众号的配置我们这里跳过,直接秀出Sdk配置代码:

    public void ConfigureServices(IServiceCollection services)
{
//注册IWxEventsHandler,如需处理自定义事件消息,请务必实现IWxEventsHandler
services.AddSingleton<IWxEventsHandler, TestWxEventsHandler>();
services.AddMPublicAccountSdk()
.AddDistributedMemoryCache()
//添加服务器消息事件处理器
.AddServerMessageHandler();
} public void Configure(IApplicationBuilder app)
{
//配置公众号Sdk
app.UseMPublicAccountSdk()
//使用分布式缓存缓存Access Token
.UseWxDistributedCacheForAccessToken();
}

2)实现IWxEventsHandler

参考代码如下所示:

/// <summary>
/// 公众号事件消息处理程序
/// </summary>
public class TestWxEventsHandler : IWxEventsHandler
{
/// <summary>
/// 执行
/// </summary>
/// <param name="fromMessage"></param>
/// <returns></returns>
public async Task<ToMessageBase> Execute(IFromMessage fromMessage)
{
if (fromMessage is FromTextMessage)
{
//返回多图文
var toMsg = new ToNewsMessage()
{
Articles = new List<ToNewsMessage.ArticleInfo>()
{
new ToNewsMessage.ArticleInfo()
{
Description = "最简洁最易于使用的微信Sdk,包括公众号Sdk、小程序Sdk、企业微信Sdk等,以及Abp VNext集成。",
PicUrl = "https://www.xin-lai.com/imgs/xinlai-logo_9d2c29c2794e6a173738bf92b056ab69.png",
Title="Magicodes.Wx.Sdk简介",
Url = "http://xin-lai.com"
}
},
FromUserName = "Test",
ToUserName = "Test"
};
return await Task.FromResult(toMsg);
}
else if (fromMessage is FromSubscribeEvent)
{
//返回文本消息
return await Task.FromResult(new ToTextMessage()
{
Content = "欢迎关注!",
});
}
else if (fromMessage is FromTextMessage)
{
//返回文本
return await Task.FromResult(new ToTextMessage()
{
Content = "Test",
});
}
return await Task.FromResult(new ToNullMessage());
}
}

相关事件和消息以及消息回复的定义,如下所示:

  • 事件推送

    • 关注事件:FromSubscribeEvent
    • 取消关注事件:FromUnsubscribeEvent
    • 扫码事件:FromScanEvent
    • 地理位置选择器事件:FromLocationEvent
    • 点击事件:FromClickEvent
    • 点击菜单链接跳转事件:FromViewEvent
    • 模板消息推送完成事件:FromTemplateSendJobFinishEvent
    • 点击菜单跳转小程序事件:FromViewMiniprogramEvent
  • 基础消息

    • 文本消息:FromTextMessage
    • 图片消息:FromImageMessage
    • 语音消息:FromVoiceMessage
    • 视频消息:FromVideoMessage
    • 小视频消息:FromShortVideoMessage
    • 地理位置消息:FromLocationMessage
    • 链接消息:FromLinkMessage
  • 被动消息回复

    • 回复文本消息:ToTextMessage
    • 回复图片消息:ToImageMessage
    • 回复语音消息:ToVoiceMessage
    • 回复视频消息:ToVideoMessage
    • 回复音乐消息:ToMusicMessage
    • 回复图文消息:ToNewsMessage
    • 回复空消息(不回复):ToNullMessage

MVC网页授权

在ASP.NET MVC,我们可以通过本SDK快速获得微信用户信息,参考代码如下所示:

//注意继承WxPublicAccountControllerBase
public class HomeController : WxPublicAccountControllerBase
{
private readonly ILogger<HomeController> _logger; public HomeController(ILogger<HomeController> logger)
{
_logger = logger;
}
//设置了WxPublicAccountOAuthFilter的Action在缓存过期的情况下,将自动跳转到微信网页授权页面进行授权
//OAuthLevel设置为OpenIdAndUserInfo允许获取粉丝信息
[WxPublicAccountOAuthFilter(OAuthLevel = OAuthLevels.OpenIdAndUserInfo)]
public async Task<IActionResult> IndexAsync()
{
//调用父级控制器的获取粉丝信息方法,该方法从ISnsApi中获取粉丝详细信息
var userResult = await GetWeChatUserInfoAsync();
var model = new UserInfo()
{
Headimgurl = userResult.Headimgurl,
NickName = userResult.NickName,
Sex = userResult.Sex
};
_logger.LogDebug($"NickName:{userResult.NickName}");
return View(model);
}
}

Abp VNext集成

Magicodes.Wx.PublicAccount.Sdk默认提供了Abp VNext模块,相关步骤如下所示:

1)安装Magicodes.Wx.PublicAccount.Sdk.Abp

Install-Package Magicodes.Wx.PublicAccount.Sdk.Abp

2)添加模块依赖

[DependsOn(
typeof(WxPublicAccountSdkModule)
)]

如需处理服务器事件消息,还需注册IWxEventsHandler:

context.Services.AddSingleton<IWxEventsHandler, WxEventsHandler>();

轻量易用的微信Sdk发布——Magicodes.Wx.Sdk的更多相关文章

  1. Wenaox 一款轻量性能好的微信小程序状态管理库

    感慨一下!!! 从开始开发 wenaox 从开始到现在,,时不时更新一下,改一改 bug,却发现已经快 1 年了 orz 虽然很少人用 hhh,但偶尔也会有人提一些问题,我就知道还有人用的~ 感兴趣的 ...

  2. 对标 Spring Boot & Cloud ,轻量框架 Solon 1.4.8 发布

    Solon 是一个轻量的Java基础开发框架.强调,克制 + 简洁 + 开放的原则:力求,更小.更快.更自由的体验.支持:RPC.REST API.MVC.Job.Micro service.WebS ...

  3. 对标 Spring Boot & Cloud ,轻量框架 Solon 1.4.12 发布

    Solon 是一个轻量的Java基础开发框架.强调,克制 + 简洁 + 开放的原则:力求,更小.更快.更自由的体验.支持:RPC.REST API.MVC.Job.Micro service.WebS ...

  4. 对标 Spring Boot & Cloud ,轻量框架 Solon 1.4.14 发布

    Solon 是一个轻量的Java基础开发框架.强调,克制 + 简洁 + 开放的原则:力求,更小.更快.更自由的体验.支持:RPC.REST API.MVC.Job.Micro service.WebS ...

  5. 对标 Spring Boot & Cloud ,轻量框架 Solon 1.5.8 发布

    Solon 是一个轻量的Java基础开发框架.强调,克制 + 简洁 + 开放的原则:力求,更小.更快.更自由的体验.支持:RPC.REST API.MVC.Job.Micro service.WebS ...

  6. 采用轻量ServiceMesh实现灰度发布的实践

    软件总会有缺陷的,解决问题的同时往往会引入新的问题,关键是看这些问题是否在我们的控制范围内,“灰度发布”就是让问题受控的方法之一. 前言 我们的 CTO 经常说:“研发团队最首要的任务是提供稳定的服务 ...

  7. 对标 Spring Boot & Cloud ,轻量框架 Solon 1.5.2 重要发布

    Solon 是一个轻量的Java基础开发框架.强调,克制 + 简洁 + 开放的原则:力求,更小.更快.更自由的体验.支持:RPC.REST API.MVC.Job.Micro service.WebS ...

  8. Snack3 3.2 发布,轻量的Json+Jsonpath框架

    Snack3 是一个轻量的 JSON + Jsonpath 框架. 借鉴了 Javascript 所有变量由 var 申明,及 Xml dom 一切都是 Node 的设计.其下一切数据都以ONode表 ...

  9. Vue.js:轻量高效的前端组件化方案(转载)

    摘要:Vue.js通过简洁的API提供高效的数据绑定和灵活的组件系统.在前端纷繁复杂的生态中,Vue.js有幸受到一定程度的关注,目前在GitHub上已经有5000+的star.本文将从各方面对Vue ...

随机推荐

  1. mybaits(七)spring整合mybaits

    与 Spring 整合分析 http://www.mybatis.org/spring/zh/index.html 这里我们以传统的 Spring 为例,因为配置更直观,在 Spring 中使用配置类 ...

  2. Linux 驱动框架---i2c驱动框架

    i2c驱动在Linux通过一个周的学习后发现i2c总线的驱动框架还是和Linux整体的驱动框架是相同的,思想并不特殊比较复杂的内容如i2c核心的内容都是内核驱动框架实现完成的,今天我们暂时只分析驱动开 ...

  3. hihoCoder Challenge 1

    #1034 : 毁灭者问题 时间限制:10000ms 单点时限:1000ms 内存限制:256MB 描述 在 Warcraft III 之冰封王座中,毁灭者是不死族打三本后期时的一个魔法飞行单位. 毁 ...

  4. Taro 版本

    Taro 版本 https://taro-docs.jd.com/taro/versions.html 1.x 1.3.34 https://taro-docs.jd.com/taro/docs/1. ...

  5. animejs 动画库

    <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8&quo ...

  6. VAST重磅出击,NGK网络搜索量超越ETH!

    Wechat指数中,NGK超越ETH,NGK搜索指数是157648点位,单日环比上涨11.95%,ETH搜索指数是115604点位,就连区块链标杆的BTC也仅仅只有171669点位,我们可清楚的看到N ...

  7. 心之所向·智慧绽放丨NGK区块链赋能实体经济论坛圆满落幕

    据外媒报导,近日,由NGK主办的"NGK区块链赋能实体经济论坛"于英国伦敦的威斯敏斯特中央大厅圆满落幕.大会现场到来了NGK北美市场领导人.区块链行业的专业人士.NGK英国社区代表 ...

  8. Laravel Queues 队列应用实战

    队列,顾名思义,排着队等着做事情.在生活场景中,凡是排队的人,都是带有目的性的.要完成某件事情,才去排队的,要不没有谁会闲到排队玩儿.而在软件应用层面,队列是什么,队列有什么优点,我们什么时候需要用队 ...

  9. Linux下安装mysql-5.7.28详细步骤

    一.下载Mysql 下载地址:https://downloads.mysql.com/archives/community/ 二.环境配置 检测系统是否自带Mysql # rmp -qa|grep m ...

  10. 京东数科二面:常见的 IO 模型有哪些?Java 中的 BIO、NIO、AIO 有啥区别?

    IO 模型这块确实挺难理解的,需要太多计算机底层知识.写这篇文章用了挺久,就非常希望能把我所知道的讲出来吧!希望朋友们能有收货!为了写这篇文章,还翻看了一下<UNIX 网络编程>这本书,太 ...