C#如何实现调取钉钉考勤接口的功能

目录

• 调取钉钉考勤接口的功能
• 下面直入正题
• 调用钉钉接口发送图片群消息
• 步骤如下

调取钉钉考勤接口的功能

公司需要做一个钉钉考勤的页面，让我去写这个功能。结果却比我想象的要麻烦一些！具体是怎么个麻烦呢

下面直入正题

首先我们找到获取钉钉考勤结果的接口。结果发现请求参数里有一个userIdList列表，那么这时候第一个问题就来了，如何获得这个userIdList呢？（注意这里的调用方式 是POST）

我们需要调用通讯录管理下的用户管理下的获取部门用户接口。来获得用户名字和用户的userId。那么这个时候 发现还需要另一个参数 部门id。那么部门id又是什么呢？（注意这里的调用方式 是GET）

我们找到了这个接口（通讯录管理下的部门管理下的获取部门列表），然后把id设置为空，就可以得到所有的部门列表了，在部门列表里找到自己部门的id即可。（注意这里的调用方式 是GET）

这样经过一波三折，总算调到了钉钉考勤的结果。注意，一次只能调取7天的哦！

当然，获取到结果之后，还需要进行对数据的分析处理等工作，经过了几天的努力我才完成。

PS:token的获得方法。

public static string GetAccess_Tocken()
       {
           var url = @"https://oapi.dingtalk.com/gettoken?appkey="+AppKey+"&appsecret="+AppSecret;
           var result = Json.ToJObject(HttpMethods.HttpGet(url));
           var tocken = result["access_token"]?.ToString();
           return tocken;
       }

小技巧：

我们可以通过在线调试快速获得部门id，快速验证接口能否使用。不过需要管理员才能使用在线调试这个功能。

调用钉钉接口发送图片群消息

前段时间我被一个需求困扰，如何调用钉钉接口发送图片消息？文字消息用string类型的参数很容易实现了，可是好像要发图片就灭有那么简单了，好在后来经过我的摸索，解决了问题。

步骤如下

要想发群消息，首先要建个钉钉群，建群的话首先要获取全局ID，要用到钉钉上的企业ID

  //全局群id
      public static  string getchatid = "";//群会话id(系统停止之后消失)
        //用于判断是否换班成功(是否成功创建新群)
      public static  Boolean flagid =false; 
        /// <summary>
        /// 获取接口全局ID
        /// </summary>
        /// <returns></returns>
        private string accessToken() {
            string corpid = "**************";
            string CorpSecret = "*******************************";
            string AccessToke = "";
            string url = string.Format("https://oapi.dingtalk.com/gettoken?appkey={0}&appsecret={1}", corpid, CorpSecret);
            JToken json = JToken.Parse(HttpUtiy.HttpGet(url));
            AccessToke = json["access_token"].ToString();
            return AccessToke;
        }     

我们这次实现的功能是，通过群成员的手机号作为参数建群，所以要根据手机号获取用户的UserID

//根据手机号获取用户UserID  
        private string UserID(string phone) {
            // 通过手机号获取 userId 
            string url = string.Format("https://oapi.dingtalk.com/user/get_by_mobile?access_token={0}&mobile={1}",accessToken(), phone);
            string userid ="找不到用户id";//用户企业内部id
            JToken json = JToken.Parse(HttpUtiy.HttpGet(url));
            if (json["errmsg"].ToString() != "找不到该用户") {
                  userid = json["userid"].ToString();
            }
            return userid;
        }

下面可以建群了，以下代码是建群方法

 /// <summary>
        /// 创建群会话
        /// </summary>
        /// <param name="phone1">值班人员1手机号</param>
        /// <param name="phone2">值班人员1手机号</param>
        /// <param name="Chatidname">群名称</param>
        public void Creatchatid(string phone1, string phone2,string Chatidname
            ) {
           
                #region 获取用户企业内部id
                //获取值班人员企业userid
                string userid = UserID(phone1);//获取用户userId(第一个人作为群主)
                string userid2 = UserID(phone2);
                //用户id添加到，成员数组。
                string[] Chatiduseridlist = new string[] { userid, userid2 };//添加到群成员列表里
                #endregion
                //判断是否正确获得用户企业id
                if (userid.Trim() == "找不到用户id" || userid2.Trim() == "找不到用户id")
                {
                    flagid = false;//获取用户id失败
                }
                else {
                    
                    #region 创建群会话
                    string MessageUrl = string.Format("https://oapi.dingtalk.com/chat/create?access_token={0}", accessToken());
                    var json_req = new
                    {
                        name = Chatidname, // 群名称
                        owner = userid,  // 群主id
                        useridlist = Chatiduseridlist
                    };
                    string jsonRequest = JsonConvert.SerializeObject(json_req);//将对象转换为字符串类型
                    JToken json = JToken.Parse(HttpUtiy.HttpPost(MessageUrl, jsonRequest));//返回值转换为JToken格式                          //赋值给成员变量，避免多次创建群。
                    getchatid = json["chatid"].ToString();
                    #endregion
                    //改变flagid标签状态
                    flagid = true;
                }               
        }

建好了群之后就可以发消息了，字符串消息很简单，像开头说的那样，代码如下

        /// <summary>
        /// 发送群消息
        /// </summary>
        public void SendMsg() {
            //发送群消息
            string MessageUrl =string.Format("https://oapi.dingtalk.com/chat/send?access_token={0}",accessToken());
            var json_req = new
            {
                chatid = getchatid,//获取群会话id
                   msg=new { 
                       msgtype="text",
                       text = new {
                           content = "有陌生人闯入，请及时查看！"
                       }     
                 }
            };
            string jsonRequest = JsonConvert.SerializeObject(json_req);//将json转位字符串
            HttpUtiy.HttpPost(MessageUrl, jsonRequest);
        }

仿照同样的格式，写出了图片消息的方法

 //发送图片消息的方法
        public void SendMsgPic()
        {
            //发送群消息
            string MessageUrl = string.Format("https://oapi.dingtalk.com/chat/send?access_token={0}", accessToken());
            var json_req = new
            {
                chatid = getchatid,//获取群会话id
                msg = new
                {
                    msgtype = "image",
                    image = new
                    {
                        media_id = "图片的媒体ID"
                    }
                }
            };
            string jsonRequest = JsonConvert.SerializeObject(json_req);//将json转位字符串
            HttpUtiy.HttpPost(MessageUrl, jsonRequest);
        }

以上为个人经验，希望能给大家一个参考，也希望大家多多支持我们。