net core WebApi——尝试企业微信来开发企业内部应用

  • 时间:
  • 浏览:15

前言

这几天忙活着别的东西,耽误了很长时间,从文件操作完了完后 就在考虑着下一步鼓捣点儿啥,将会最之前 开始的业务开发就是企业微信相关的,这刚好来做个外部应用的小例子玩玩。

企业微信

前身是企业号,当时微信主推的还是公众号与服务号,后续战略考虑到企业的OA了(当然还是跟某个抢市场),企业号应该是在16年还是具体啥完后 出的,刚出的完后 也是什么的问题不断一直在修复更新,最近这两年基本上没咋关注企业微信了,所以是 偶尔上去看看有越来越 新东西啊哪此的,不过不得不说,在这几年的成长中将会修复逐渐成为有有另一一三个不错的产品了(大厂的传输速率还是有的),相对于公众号的开发,为哪此我选你这些 作为例子呢,将会企业微信让我通过当事人来使用(注册的早,现在不清楚注册流程,主要看与否前要企业认证),当事人开发者在不论啥完后 啥平台都你这些 你这些 不友好(当然,认证了说明你是个好人,为了信息安全,都懂)。

之前 开始

注册企业微信的流程让我太满说了,直接说注册完成完后 ,我们我们我们我们都 歌词 来看下你这些 界面,标注的就是我们我们我们我们都 歌词 前要的关键参数。

记好你这些 东西完后 ,我们我们我们我们都 歌词 转到应用管理

你这些 创建就在等你添张图片打个名字而已,太满说,创建完成完后 我们我们我们我们都 歌词 来看下图的标记。

记好这有有另一一三个参数,OK,下来我们我们我们我们都 歌词 就来看API吧,这里我就是介绍下消息推送。

微信等相关的第三方开发大致流程都累似 ,如下:

  1. 注册账号(这不废话么)
  2. 账号认证(为了权限,当然企业微信外部应用不前要)
  3. 服务域名挑选好
  4. AppID、Secret等等的配置(为了accesstoken)
  5. 几乎所有的接口与否 先获取accesstoken,离米 你在微信的登录
  6. 根据接口文档来传参啊获取消调啊获取事件等等
  7. 根据返回值来看看错误信息

我这里不做服务端,就是写个示例,前要服务端哪此的开发累似 的能并能给我联系,互相学习。

首先,在我们我们我们我们都 歌词 的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 = 100)
        {
            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 = 100)
        {
            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("1001");
            QyThridUtil.SendMessage("我就是来测试", range, AprilEnums.MessageType.Text);
            //…
        }

小结

写到这里基本上都之前 开始,为哪此我特意拿下来企业微信的外部应用来写这篇呢,虽然是做下你这些 消息推送,完后 的当事人的工程就能并能写个你这些 就是做异常警告累似 的东西,另有另一一三个能想这篇就与否 废话了,编程的奇淫技巧(咳咳,乐趣,乐趣)就在于此,代码当事人敲,东西当事人组,全在于你当事人为社 么玩了。