net core WebApi——嘗試企業微信來開發企業內部應用

来源:https://www.cnblogs.com/AprilBlank/archive/2019/09/02/11447390.html
-Advertisement-
Play Games

@[toc] 前言 這幾天忙活著別的東西，耽誤了很長時間，從文件操作完了之後就在考慮著下一步鼓搗點兒啥，因為最開始的業務開發就是企業微信相關的，這剛好來做個內部應用的小例子玩玩。 企業微信 前身是企業號，當時微信主推的還是公眾號與服務號，後續戰略考慮到企業的OA了（當然還是跟某個搶市場），企業號應該 ...


目錄

@

前言

這幾天忙活著別的東西，耽誤了很長時間，從文件操作完了之後就在考慮著下一步鼓搗點兒啥，因為最開始的業務開發就是企業微信相關的，這剛好來做個內部應用的小例子玩玩。

企業微信

前身是企業號，當時微信主推的還是公眾號與服務號，後續戰略考慮到企業的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 = 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);
            //…
        }

測試

測試

小結

寫到這裡基本上都結束了，為什麼我特意拿出來企業微信的內部應用來寫這篇呢，其實是做下這個消息推送，以後的自己的工程就可以寫個這個然後做異常警告之類的東西，這樣想想這篇就不是廢話了，編程的奇淫技巧（咳咳，樂趣，樂趣）就在於此，代碼自己敲，東西自己組，全在於你自己怎麼玩了。


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • C#中使用FilleStream實現視頻文件的複製
    場景 C#中FileStream的對比以及使用方法： https://blog.csdn.net/BADAO_LIUMANG_QIZHI/article/details/100396022 關註公眾號霸道的程式猿獲取編程相關電子書、教程推送與免費下載。 實現 新建控制台程式 在main方法中 然後實 ...
  • 從零開始搭建前後端分離的NetCore2.2（EF Core CodeFirst+Autofac）+Vue的項目框架之六使用過濾器進行全局請求數據驗證
    在 上一篇 中講到了在NetCore項目中如何進行全局異常處理，當手動拋出或系統未處理異常出現時進行的一個攔截處理。 本節中將講到API請求模型的一個驗證，先拋出幾個問題， 在ASP.NET Core MVC 中提供了很多內置特性，一下是一些比較常用的內置特性： 以下是一些內置驗證特性： [Cred ...
  • Redis的初識
    簡介 已經有了Membercache和各種資料庫，Redis為什麼會產生?Redis純粹為應用而產生，它是一個高性能的key-value資料庫。Redis的出現，很大程式補償了Memcached這類key-value存儲的不足，解決了斷電後資料庫完全丟失的情況；在部分場合可以對關係資料庫起到很好的補 ...
  • C#中using的使用-以FileStream寫入文件為例
    場景 CS中FileStream的對比以及使用方法： https://blog.csdn.net/BADAO_LIUMANG_QIZHI/article/details/100396022 關註公眾號霸道的程式猿獲取編程相關電子書、教程推送與免費下載。 實現 將創建文件流對象的過程寫在using中， ...
  • C#中FileStream的對比以及使用方法
    場景 File與FileStream的區別 舉例： 將讀取文件比作是從A桶往B桶運水。 使用File就是整個用桶倒進去，使用FileStream就是使用水管慢慢輸送。 FileStream與StreamReader的區別 FileStream是操作位元組的，即可以操作任意一種類型的文件。 Stream ...
  • abp(net core)+easyui+efcore實現倉儲管理系統——菜單 (十六)
    在前面的文章(abp(net core)+easyui+efcore實現倉儲管理系統——展現層實現增刪改查之菜單與測試（九） )中我們學會瞭如何添加靜態菜單，但是做為一個信息管理系統，總不能每次有新功能新菜單，都靜態添加菜單，編譯，再上線。我們希望的是有一個菜單管理界面，在此頁面中輸入相應的菜單，只... ...
  • VS2019沒有.net core3.0模板的解決辦法
    今天裝好了,net core sdk 3.0之後，打開Visual Studio2019後，新建項目時發現盡然沒有.net core3.0的模板。 搜了下其他博主的文章，按照文章里做瞭如下設置： 然後發現，這些設置沒有用！！！依然顯示不出3.0的模板。 經過一下午的折騰，重裝了core sdk，重裝 ...
  • .netcore 分散式事務CAP2.6之控制台使用
    上一編講了cap2.6的快速入門，這次我們來講講在控制臺中如何使用cap2.6。因為cap2.6的記憶體模式目前已經可以使用了，相關組件已經更新，所以這次我們以簡單的記憶體模式為例。 1：創建項目 創建一個名叫CAPConsoleDemo的 “控制台應用(.NET Core)” 程式，.netcore版 ...
一周排行
    -Advertisement-
    Play Games
  • WPF 已知問題 監聽 WMI 事件導致觸摸失效
    示例項目結構 在 Visual Studio 中創建一個 WinForms 應用程式後，項目結構如下所示： MyWinFormsApp/ │ ├───Properties/ │ └───Settings.settings │ ├───bin/ │ ├───Debug/ │ └───Release/ ...
  • [STAThread]特性
    [STAThread] 特性用於需要與 COM 組件交互的應用程式，尤其是依賴單線程模型（如 Windows Forms 應用程式）的組件。在 STA 模式下，線程擁有自己的消息迴圈，這對於處理用戶界面和某些 COM 組件是必要的。 [STAThread] static void Main(stri ...
  • UWP WinUI3 傳入 AddHandler 的 RoutedEventHandler 類型與事件所需不匹配將拋出參數異常
    在WinForm中使用全局異常捕獲處理 在WinForm應用程式中，全局異常捕獲是確保程式穩定性的關鍵。通過在Program類的Main方法中設置全局異常處理，可以有效地捕獲並處理未預見的異常，從而避免程式崩潰。 註冊全局異常事件 [STAThread] static void Main() { / ...
  • .NET 多版本 WinForm 開源控制項庫 SunnyUI
    前言 給大家推薦一款開源的 Winform 控制項庫，可以幫助我們開發更加美觀、漂亮的 WinForm 界面。 項目介紹 SunnyUI.NET 是一個基於 .NET Framework 4.0+、.NET 6、.NET 7 和 .NET 8 的 WinForm 開源控制項庫，同時也提供了工具類庫、擴展 ...
  • .net core8 使用Swagger（附當前源碼）
    說明 該文章是屬於OverallAuth2.0系列文章，每周更新一篇該系列文章（從0到1完成系統開發）。 該系統文章，我會儘量說的非常詳細，做到不管新手、老手都能看懂。 說明：OverallAuth2.0 是一個簡單、易懂、功能強大的許可權+可視化流程管理系統。 有興趣的朋友，請關註我吧(*^▽^*) ...
  • WPF 什麼時候 VisualTreeHelper.GetDescendantBounds 將返回無窮大
    一、下載安裝 1.下載git 必須先下載並安裝git，再TortoiseGit下載安裝 git安裝參考教程：https://blog.csdn.net/mukes/article/details/115693833 2.TortoiseGit下載與安裝 TortoiseGit，Git客戶端，32/6 ...
  • C# 開源教程帶你輕鬆掌握數據結構與演算法
    前言 在項目開發過程中，理解數據結構和演算法如同掌握蓋房子的秘訣。演算法不僅能幫助我們編寫高效、優質的代碼，還能解決項目中遇到的各種難題。 給大家推薦一個支持C#的開源免費、新手友好的數據結構與演算法入門教程：Hello演算法。 項目介紹 《Hello Algo》是一本開源免費、新手友好的數據結構與演算法入門 ...
  • 第22篇 生成proto文件bat腳本
    1.生成單個Proto.bat內容 @rem Copyright 2016, Google Inc. @rem All rights reserved. @rem @rem Redistribution and use in source and binary forms, with or with ...
  • 記一次 .NET某上位機視覺程式 卡死分析
    一：背景 1. 講故事 前段時間有位朋友找到我，說他的窗體程式在客戶這邊出現了卡死，讓我幫忙看下怎麼回事？dump也生成了，既然有dump了那就上 windbg 分析吧。 二：WinDbg 分析 1. 為什麼會卡死 窗體程式的卡死，入口門檻很低，後續往下分析就不一定了，不管怎麼說先用 !clrsta ...
  • 醫學DICOM文件與PACS系統進行數據傳輸
    前言 人工智慧時代，人臉識別技術已成為安全驗證、身份識別和用戶交互的關鍵工具。 給大家推薦一款.NET 開源提供了強大的人臉識別 API，工具不僅易於集成，還具備高效處理能力。 本文將介紹一款如何利用這些API，為我們的項目添加智能識別的亮點。 項目介紹 GitHub 上擁有 1.2k 星標的 C# ...
所有分類