net core WebApi——尝试企业微信内部应用
前言
这几天忙活着别的东西,耽误了很长时间,从文件操作完了之后就在考虑着下一步鼓捣点儿啥,因为最开始的业务开发就是企业微信相关的,这刚好来做个内部应用的小例子玩玩。
企业微信
前身是企业号,当时微信主推的还是公众号与服务号,后续战略考虑到企业的OA了(当然还是跟某个抢市场),企业号应该是在16年还是具体啥时候出的,刚出的时候也是问题不断一直在修复更新,最近这两年基本上没咋关注企业微信了,也都是偶尔上去看看有没有新东西啊什么的,不过不得不说,在这几年的成长中已经修复逐渐成为一个不错的产品了(大厂的效率还是有的),相对于公众号的开发,为什么我选这个作为例子呢,因为企业微信我可以通过个人来使用(注册的早,现在不清楚注册流程,主要看是否需要企业认证),个人开发者在不论啥时候啥平台都或多或少有些不友好(当然,认证了说明你是个好人,为了信息安全,都懂)。
开始
注册企业微信的流程我就不多说了,直接说注册完成之后,我们来看下这个界面,标注的就是我们需要的关键参数。
记好这个东西之后,我们转到应用管理。
这个创建就是你添张图片打个名字而已,不多说,创建完成之后我们来看下图的标记。
记好这两个参数,OK,下来我们就来看API吧,这里我只是介绍下消息推送。
微信等相关的第三方开发大致流程都类似,如下:
- 注册账号(这不废话么)
- 账号认证(为了权限,当然企业微信内部应用不需要)
- 服务域名确定好
- AppID、Secret等等的配置(为了accesstoken)
- 几乎所有的接口都是先获取accesstoken,相当于你在微信的登录
- 根据接口文档来传参啊获取回调啊获取事件等等
- 根据返回值来看看错误信息
我这里不做服务端,只是写个示例,需要服务端什么的开发之类的可以给我联系,互相学习。
首先,在我们的Util新建一个类QyThirdUtil(名字感觉起的好没水平,玩游戏止于起名字,别人都10级了,我还在想名字),先把我们需要的配置信息搞了。
private static string _CorpID = string.Empty;
private static string _Secret = string.Empty;
private static string _AgentID = string.Empty;
/// <summary>
/// 企业微信id
/// </summary>
public static string CorpID
{
get
{
if (string.IsNullOrEmpty(_CorpID))
{
_CorpID = AprilConfig.Configuration["QyThird:CorpID"];
}
return _CorpID;
}
}
/// <summary>
/// 企业微信应用秘钥
/// </summary>
public static string Secret
{
get
{
if (string.IsNullOrEmpty(_Secret))
{
_Secret = AprilConfig.Configuration["QyThird:Secret"];
}
return _Secret;
}
}
/// <summary>
/// 企业微信应用id
/// </summary>
public static string AgentID
{
get
{
if (string.IsNullOrEmpty(_Secret))
{
_AgentID = AprilConfig.Configuration["QyThird:AgentID"];
}
return _AgentID;
}
}
然后我们来划分下方法,我们需要获取accesstoken,需要执行发送消息的方法。
/// <summary>
/// 获取AccessToken
/// </summary>
/// <returns></returns>
public static string GetAccessToken()
{
QyAccessToken accessToken = null;
bool isGet = false;
if (CacheUtil.Exists("QyAccessToken"))
{
accessToken = CacheUtil.Get<QyAccessToken>("QyAccessToken");
if (accessToken.Expire_Time >= DateTime.Now.AddMinutes(1))
{
isGet = true;
}
}
if (!isGet)
{
string url = $"https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid={CorpID}&corpsecret={Secret}";
//请求获取
string res = RequestUtil.HttpGet(url);
accessToken = JsonConvert.DeserializeObject<QyAccessToken>(res);
if (accessToken != null && accessToken.ErrCode == 0)
{
accessToken.Expire_Time = DateTime.Now.AddSeconds(accessToken.Expires_In);
CacheUtil.Set("QyAccessToken", accessToken, new TimeSpan(2, 0, 0));
}
else
{
LogUtil.Error($"获取accesstoken失败——{accessToken.ErrCode},{accessToken.ErrMsg}");
}
}
return accessToken.Access_Token;
}
这里用到了两个地方,一个是微信端回调的对象实例QyAccessToken,需要的朋友可以在源码里cv,我这里就不贴出来了。
另一个是HttpClient的简单封装请求方法RequestUtil,看了有些博客说HttpClient的生命周期之类的,有推荐直接实例化一个私有静态的,也有做工厂模式创建的,没细究,这块儿要多注意下。
public class RequestUtil
{
/// <summary>
/// 发起POST同步请求
/// </summary>
/// <param name="url">请求地址</param>
/// <param name="postData">请求数据</param>
/// <param name="contentType">数据类型</param>
/// <param name="timeOut">超时时间</param>
/// <returns></returns>
public static string HttpPost(string url, string postData = null, string contentType = null, int timeOut = 30)
{
if (string.IsNullOrEmpty(postData))
{
postData = "";
}
using (HttpClient client = new HttpClient())
{
client.Timeout = new TimeSpan(0, 0, timeOut);
using (HttpContent httpContent = new StringContent(postData, Encoding.UTF8))
{
if (contentType != null)
httpContent.Headers.ContentType = new System.Net.Http.Headers.MediaTypeHeaderValue(contentType);
HttpResponseMessage response = client.PostAsync(url, httpContent).Result;
return response.Content.ReadAsStringAsync().Result;
}
}
}
/// <summary>
/// 发起POST异步请求
/// </summary>
/// <param name="url">请求地址</param>
/// <param name="postData">请求数据</param>
/// <param name="contentType">数据类型</param>
/// <param name="timeOut">超时时间</param>
/// <returns></returns>
public static async Task<string> HttpPostAsync(string url, string postData = null, string contentType = null, int timeOut = 30)
{
if (string.IsNullOrEmpty(postData))
{
postData = "";
}
using (HttpClient client = new HttpClient())
{
client.Timeout = new TimeSpan(0, 0, timeOut);
using (HttpContent httpContent = new StringContent(postData, Encoding.UTF8))
{
if (contentType != null)
httpContent.Headers.ContentType = new System.Net.Http.Headers.MediaTypeHeaderValue(contentType);
HttpResponseMessage response = await client.PostAsync(url, httpContent);
return await response.Content.ReadAsStringAsync();
}
}
}
/// <summary>
/// 发起GET同步请求
/// </summary>
/// <param name="url">请求地址</param>
/// <returns></returns>
public static string HttpGet(string url)
{
using (HttpClient client = new HttpClient())
{
return client.GetStringAsync(url).Result;
}
}
/// <summary>
/// 发起GET异步请求
/// </summary>
/// <param name="url">请求地址</param>
/// <returns></returns>
public static async Task<string> HttpGetAsync(string url)
{
using (HttpClient client = new HttpClient())
{
HttpResponseMessage response = await client.GetAsync(url);
return await response.Content.ReadAsStringAsync();
}
}
}
然后我们来写个发送消息的方法SendMessage,这里我只写了下普通文本推送。
/// <summary>
/// 消息推送
/// </summary>
/// <param name="content">文本内容</param>
/// <param name="range">推送范围</param>
/// <param name="messageType">消息类型</param>
/// <returns></returns>
public static bool SendMessage(string content, MessageRange range, AprilEnums.MessageType messageType)
{
bool isSend = false;
if (string.IsNullOrEmpty(content) || content.Length > 2048 || range==null)
{
return false;
}
string accessToken = GetAccessToken();
if (string.IsNullOrEmpty(accessToken))
{
return false;
}
string url = $"https://qyapi.weixin.qq.com/cgi-bin/message/send?access_token={accessToken}";
StringBuilder data = new StringBuilder();
bool isVaildRange = false;
if (range.IsAll)
{
data.Append($"\"touser\":\"@all\"");
isVaildRange = true;
}
else
{
if (range.Users != null && range.Users.Count > 0)
{
data.AppendFormat("\"touser\" : {0}", GetRangeValue(range.Users));
isVaildRange = true;
}
if (range.Tags != null && range.Tags.Count > 0)
{
if (data.Length > 0)
{
data.Append(",");
}
data.AppendFormat("\"totag\" : {0}", GetRangeValue(range.Tags));
isVaildRange = true;
}
if (range.Departments != null && range.Departments.Count > 0)
{
if (data.Length > 0)
{
data.Append(",");
}
data.AppendFormat("\"totag\" : {0}", GetRangeValue(range.Departments));
isVaildRange = true;
}
}
if (!isVaildRange)
{
//没有发送范围
return false;
}
data.AppendFormat(",\"msgtype\":\"{0}\"", GetMessageType(messageType));
data.AppendFormat(",\"agentid\":\"{0}\"", AgentID);
data.Append(",\"text\": {");
data.AppendFormat("\"content\":\"{0}\"", content);
data.Insert(0, "{");
data.Append("}}");
LogUtil.Debug($"获取到发送消息请求:{data.ToString()}");
string res = RequestUtil.HttpPost(url, data.ToString(), "application/json");
LogUtil.Debug($"获取到发送消息回调:{res}");
return false;
}
简单说下消息推送,第一个就是你的推送类型,是普通文本还是啥(文档都有,我这净扯淡),然后就是你的范围,再然后就是你的推送内容了,当然根据不同的推送类型你的内容参数也不同,需要进一步封装的朋友可以去看下API。
测试
我们在控制器中(不再说Values了)加上消息推送的测试,这里的范围可以在你自己的通讯录中查看。
[HttpGet]
public ActionResult<IEnumerable<string>> Get()
{
//…
MessageRange range = new MessageRange();
range.Users = new List<string>();
range.Users.Add("10001");
QyThridUtil.SendMessage("我就是来测试", range, AprilEnums.MessageType.Text);
//…
}
小结
写到这里基本上都结束了,为什么我特意拿出来企业微信的内部应用来写这篇呢,其实是做下这个消息推送,以后的自己的工程就可以写个这个然后做异常警告之类的东西,这样想想这篇就不是废话了,编程的奇淫技巧(咳咳,乐趣,乐趣)就在于此,代码自己敲,东西自己组,全在于你自己怎么玩了。
net core WebApi——尝试企业微信内部应用的更多相关文章
- .NET Core企业微信网页授权登录
1.开发前准备 参数获取 corpid 每个企业都拥有唯一的corpid,获取此信息可在管理后台"我的企业"-"企业信息"下查看"企业ID" ...
- 【原创】在 ASP.NET Core 3.1 中使用 Senparc.Weixin.Work 企业微信 SDK —— 发送文本消息
下面在 Web 空应用里展示一个简单的例子来实现发送文本消息. 本文目录: 创建 Web 空应用 命令行方式创建 添加SDK引用 命令行方式 进入项目目录 添加包引用 配置和使用SDK 添加appse ...
- 【原创】在 .NET Core 3.1 中使用 Senparc.Weixin.Work 企业微信 SDK —— 发送文本消息
下面在控制台应用里展示一个简单的例子来实现发送文本消息. 本文目录: 创建控制台应用 添加SDK引用 命令行方式 进入项目目录 添加包引用 配置和使用SDK 添加appsettings.json文件 ...
- 团队内部密码共享方案:KeePassXC+微盘(企业微信)
目录 需求描述 适用场景 安装使用 KeePassXC初始化 浏览器插件安装设置 1.火狐 2.Edge 3.Chrome 软件-插件的链接 登陆网站并保存密码 (企业微信)微盘共享内部数据库 其他 ...
- .NET Core 企业微信消息推送
接口定义 应用支持推送文本.图片.视频.文件.图文等类型.请求方式:POST(HTTPS)请求地址: https://qyapi.weixin.qq.com/cgi-bin/message/send? ...
- Asp.Net Core 企业微信静默授权
企业微信接口文档 1.构造授权网页链接 2.回调获取到 Code 通过code+access_token去请求用户信息 3.获取access_token 调试准备工作 -->内网穿透+域名 推荐 ...
- Python接入企业微信 - 推送信息到内部群里
前言 之前一篇文章提到了使用wechatpy库来实现企业微信应用登录:Django + Taro 前后端分离项目实现企业微信登录 其实这个库可以实现的功能非常多,基本微信开发涉及到的功能都能实现. 本 ...
- .NET Core 企业微信回调配置
1.配置API接收 2.下载加密解密库 地址:https://developer.work.weixin.qq.com/devtool/introduce?id=36388,也可以复制下面的代码 2. ...
- .Net Core 企业微信更新模版卡片消息
1.搭建回调服务器 可参考:https://www.cnblogs.com/zspwf/p/16381643.html进行搭建 2.编写代码 2.1接口定义 应用可以发送模板卡片消息,发送之后可再通过 ...
随机推荐
- java练习---2
//程序员:罗元昊 2017.9.6public class My{ public static void main(String[] args){ int a= ...
- .Net MVC 动态生成LayUI tree
.Net MVC 动态生成LayUI tree 最近在做项目的过程中需要用到Tree插件,所以找了一堆Tree发现LayUI的Tree样式比较好看,所以开始搞! 1.Layui部分 1.1 首先引用文 ...
- window下不用安装虚拟机,也可以玩转linux,玩转最新redis
想要了解redis的最新特性,可是windows下的可以安装的版本最高为3.2,想要验证redis的诸如stream特性的话,就无能为力了. 解决方法之一在windows上安装虚拟机,然后再虚拟机上安 ...
- for循环打印空心菱形的新方法
相信大家在学习流程控制的循环结构时,一定都用for循环绘制过菱形和空心菱形吧,我记得我当时写的很麻烦,把一个菱形分为上下两部分,上面2重for循环,下面2重for循环,相信有很多的小伙伴都是这样做的吧 ...
- zmnXAglTcg
#include <map>#include <cmath>#include <stack>#include <queue>#include <l ...
- 禅道、jenkins部署记录
禅道部署1.检查你linux系统的位数(uname -a)2.下载对应位数的禅道包3.通过xftp工具将禅道包拷贝到虚拟机的/opt目录4.tar 对禅道包进行解压5.改配置:vi /opt/zbox ...
- ABP实现EF执行SQL(增删改查)解决方案
前言 一般情况下,使用EF中的语法可以帮助我们完成绝大部分业务,但是也有特殊的情况需要直接执行的Sql语句.比如,我们的业务过于复杂繁琐,或是有些业务使用EF操作时比较复杂,但是使用的Sql时会很简单 ...
- RBF神经网络
RBF神经网络 RBF神经网络通常只有三层,即输入层.中间层和输出层.其中中间层主要计算输入x和样本矢量c(记忆样本)之间的欧式距离的Radial Basis Function (RBF)的值,输出层 ...
- Opengl_入门学习分享和记录_02_渲染管线(一)顶点输入
现在前面的废话:最近好事不断!十分开心!生活真美好! 好了今天要梳理一下,顶点输入的具体过程,同样也是渲染管线中的第一个阶段的详细过程的介绍.之前介绍过,OpenGL操作的是一组3D坐标,所以我们的输 ...
- Spring入门(六):条件化的bean
1. 概念 默认情况下,Spring中定义的bean在应用程序启动时会全部装配,不管当前运行的是哪个环境(Dev,QA或者Prod),也不管当前运行的是什么系统(Windows或者Linux),但有些 ...