概述
Magicodes.Wx.Sdk致力于打造最简洁最易于使用的微信Sdk,逐步包括公众号Sdk、小程序Sdk、企业微信Sdk等,以及Abp VNext集成。
本篇将侧重于讲述如何向Magicodes.Wx.Sdk进行贡献。
WebApiClientCore
Magicodes.Wx.Sdk之简洁很大层面依托于NCC的开源库WebApiClientCore。Magicodes.Wx.Sdk依托WebApiClientCore完成了微信接口的包装和校验。
开源库地址:https://github.com/dotnetcore/WebApiClient
快速开始
这里我们以【客服消息】【添加客服账号】为例进行讲解,官方接口文档地址为:https://developers.weixin.qq.com/doc/offiaccount/Customer_Service/Customer_Service_Management.html#2。
比如添加客服账号接口官方接口文档说明如下所示:
![添加客服账号](https://i-blog.csdnimg.cn/blog_migrate/b3798028d1211bdd1ca9de1c592f12d0.png)
主体步骤如下:
1)添加接口IKfAccountApi
参考代码如下所示:
/// <summary>
/// 客服管理
/// </summary>
[HttpHost("https://api.weixin.qq.com/customservice/kfaccount/")]
public interface IKfAccountApi : IWxApiWithAccessTokenFilter
{
/// <summary>
/// 添加客服账号
/// </summary>
/// <param name="input"></param>
/// <returns></returns>
[HttpPost("add")]
Task<ApiResultBase> AddAsync(AddOrUpdateKfAccountInput input);
/// <summary>
/// 设置客服信息
/// </summary>
/// <param name="input"></param>
/// <returns></returns>
[HttpPost("update")]
Task<ApiResultBase> UpdateAsync(AddOrUpdateKfAccountInput input);
/// <summary>
/// 删除客服账号
/// </summary>
/// <param name="input"></param>
/// <returns></returns>
[HttpPost("del")]
Task<ApiResultBase> DelAsync(DelKfAccountInput input);
}
如上述代码所示,有几个注意事项:
-
需要定义接口
-
继