Asp.Net 企业微信第三方应用开发(随手笔记)

C#企业微信第三方应用开发

  • OAuth2简介
    • 1.注册企业
    • 2.新建第三方应用
    • 3.网页授权链接

OAuth2简介

OAuth2的设计背景,在于允许用户在不告知第三方自己的帐号密码情况下,通过授权方式,让第三方服务可以获取自己的资源信息。

1.注册企业

  1. 注册地址:链接地址;
  2. 注册完后跳转到登录页面,下次访问页面时是支持手机端APP企业微信扫描登录的;
  3. 登录地址:链接地址;

2.新建第三方应用

1.应用-自建-创建应用,示例:
Asp.Net 企业微信第三方应用开发(随手笔记)_第1张图片

3.网页授权链接

官方API地址:链接地址

1.获取Code,需要准备企业ID(appid),企业应用ID(agentid),回调地址(指手机端企业微信的应用默认地址,企业微信接口会把Code返回给这个地址)

1.1.官方示例截图:
Asp.Net 企业微信第三方应用开发(随手笔记)_第2张图片
1.2.应用ID位置截图(应用ID在最近新建的应用里面,点击打开就能看见)
Asp.Net 企业微信第三方应用开发(随手笔记)_第3张图片
1.3.企业ID截图
Asp.Net 企业微信第三方应用开发(随手笔记)_第4张图片
代码示例:
Asp.Net 企业微信第三方应用开发(随手笔记)_第5张图片
注意

 1. 回调的网址必须放在公网上,不然企业微信访问不了。(这里建议使用**花生壳**内网穿透)
 2. 必须发布在IIS站点下面,这里是不好调试的

2.获取身份验证的suite_access_token

官方API地址:链接地址

2.1.官方示例截图:
Asp.Net 企业微信第三方应用开发(随手笔记)_第6张图片
2.2应用secret位置截图:
Asp.Net 企业微信第三方应用开发(随手笔记)_第7张图片
代码示例:

        /// 
        /// 获取token
        /// 
        /// 企业ID,也叫corpid,可以找微信号中可以找到
        /// 应用的凭证密钥
        /// 
        public string GetObtainToke()
        {
            try
            {
                string appid = "ww1769a401136be1bb";
                var secret = "mZwzx6k7EuvIfyrtgEjPEzLOG69ZHkiDlRftH7vgRps";
                string url = "https://qyapi.weixin.qq.com/cgi-bin/gettoken?";
                StringBuilder str = new StringBuilder();
                str.Append(url);
                str.Append("corpid=" + appid + "&corpsecret=" + secret + "");
                string Tokes = HttpUtils.DoGet(str.ToString(), null).ToString();
                dynamic jsondata = JToken.Parse(Tokes) as dynamic;
                Log.CreateLogManager().Error("获取access_token状态为:" + jsondata["errcode"]);

                if (jsondata["errcode"] == 0)
                {
                    return jsondata["access_token"];
                }
                else
                {
                    return "";
                }
            }
            catch (Exception ex)
            {
                Log.CreateLogManager().Error("获取access_token出现异常:" + ex);
                return "";
            }
        }

3.获取用户信息

官网API地址:链接地址

官网截图:
Asp.Net 企业微信第三方应用开发(随手笔记)_第8张图片

代码示例:

        /// 
        /// 企业微信登录方法(获取用户名)
        /// 
        /// 
        /// 
        /// 
        public Object GetUserLoginBs(string code,string state)
        {
            DateTime dr = DateTime.Now;

            object encryptTicket = new { };

            try
            {
                if (code != null)
                {
                    string Token = GetObtainToke();
                    if (Token != "")
                    {
                        string UserUrl = "https://qyapi.weixin.qq.com/cgi-bin/user/getuserinfo?";
                        StringBuilder UserStr = new StringBuilder();
                        UserStr.Append(UserUrl);
                        UserStr.Append("access_token=" + Token + "&code=" + code + "");
                        string JsonValue = HttpUtils.DoGet(UserStr.ToString(), null).ToString();
                        dynamic ResultValue = JToken.Parse(JsonValue) as dynamic;
                        Log.CreateLogManager().Error("获取企业微信用户状态为:" + ResultValue["errcode"]);
                        Log.CreateLogManager().Error("获取企业微信用户UserId为:" + ResultValue["UserId"]);

                        if (ResultValue["errcode"] == 0)
                        {
                            string User = ResultValue["UserId"];
                            string StaffUrl = "https://qyapi.weixin.qq.com/cgi-bin/user/get?";
                            StringBuilder StaffStr = new StringBuilder();
                            StaffStr.Append(StaffUrl);
                            StaffStr.Append("access_token=" + Token + "&userid=" + User + "");
                            string StaffResult = HttpUtils.DoGet(StaffStr.ToString(), null).ToString();
                            Root jsonStaff = Newtonsoft.Json.JsonConvert.DeserializeObject(StaffResult);

                            if (jsonStaff.errcode == 0)
                            {

                            }
                            else
                            {
                                encryptTicket = new { Success = false, Msg = "员工号获取失败" };
                            }
                        }
                        else
                        {
                            encryptTicket = new { Success = false, Msg = "UserID获取失败" };
                        }
                    }
                    else
                    {
                        encryptTicket = new { Success = false, Msg = "access_token获取失败" };
                    }
                }
            }
            catch (Exception ex)
            {
                encryptTicket = new { Success = false, Msg = "出现异常" };
                Log.CreateLogManager().Error("异常:" + ex);
            }

            return encryptTicket;
        }

你可能感兴趣的:(.NET,Framework)