關(guān)注點(diǎn)：

• 1、釘釘AccessToken的獲取和防止過(guò)期
• 2、使用TPL并行編程調(diào)用釘釘接口

需求詳解

公司前臺(tái)有個(gè)大屏，領(lǐng)導(dǎo)想顯示全部員工的考勤結(jié)果統(tǒng)計(jì)情況和車(chē)間的實(shí)時(shí)監(jiān)控視頻，還有車(chē)間的看板。簡(jiǎn)單說(shuō)就是把大屏分割成幾個(gè)區(qū)域。現(xiàn)在遇到的難題是釘釘獲取考勤結(jié)果的api是只有明細(xì)記錄，比如你公司1000人，那么可能回給你2000條考勤結(jié)果。分別是上班考勤和下班考勤的。沒(méi)有整個(gè)公司的，我就需要這么一條數(shù)據(jù)就行了。但人家沒(méi)有這樣的接口提供。卷起袖子，干！

趟坑過(guò)程

考勤打卡數(shù)據(jù)開(kāi)放

• 業(yè)務(wù)場(chǎng)景
• 考勤打卡數(shù)據(jù)開(kāi)放

業(yè)務(wù)場(chǎng)景

該接口僅限企業(yè)接入使用，用于返回企業(yè)內(nèi)員工的實(shí)際打卡結(jié)果。比如，企業(yè)給一個(gè)員工設(shè)定的排班是上午9點(diǎn)和下午6點(diǎn)各打一次卡，即使員工在這期間打了多次，該接口也只會(huì)返回兩條記錄，包括上午的打卡結(jié)果和下午的打卡結(jié)果

考勤打卡數(shù)據(jù)開(kāi)放

請(qǐng)求說(shuō)明（ISV無(wú)調(diào)用權(quán)限）
如果你是ISV（應(yīng)用服務(wù)商，將開(kāi)發(fā)的應(yīng)用上架到釘釘應(yīng)用市場(chǎng)，提供給釘釘其他企業(yè)用戶使用），則無(wú)調(diào)用權(quán)限
如果你是企業(yè)內(nèi)部開(kāi)發(fā)者（將自己公司的HR、OA、客戶管理、業(yè)務(wù)管理等系統(tǒng)接入釘釘），有權(quán)限調(diào)用
2017-10-16更新：新增用戶userId列表參數(shù)(userIdList)和分頁(yè)參數(shù)(offset,limit)，提升接口穩(wěn)定性。

Https請(qǐng)求方式: POST

https://oapi.dingtalk.com/attendance/list?access_token=ACCESS_TOKEN

請(qǐng)求包結(jié)構(gòu)體

參數(shù)說(shuō)明

1)獲取AccessToken

釘釘?shù)姆?wù)器很牛X可以并行訪問(wèn)的。但是獲取回來(lái)的數(shù)據(jù)集有點(diǎn)亂，其中有個(gè)關(guān)于分頁(yè)的參數(shù)需要順序讀取，就是“hasMore”還有沒(méi)有下一頁(yè)。所以最終沒(méi)有使用TPL。

        /// <summary>
        /// 獲取AccessToken
        /// </summary>
        /// <returns></returns>
        private AccessToken GetAccessToken()
        {
            string URL_GetToken = "https://oapi.dingtalk.com/gettoken?corpid={0}&corpsecret={1}";
            string fileName = AppDomain.CurrentDomain.BaseDirectory + "AccessToken.xml";
            if (!System.IO.File.Exists(fileName))
            {
                string respon = Program.HttpGetRequest(string.Format(URL_GetToken, Program.CorpId, Program.CorpSecret));
                DingTalkRespond obj = JsonConvert.DeserializeObject<DingTalkRespond>(respon);
                if (obj != null && obj.errcode == 0)
                {
                    var result = new AccessToken
                    {
                        access_token = obj.access_token,
                        expires_in = GetCurrentTimeStamp()
                    };
                    SerializerHelper.SerializerToXML(fileName, result);
                    return result;
                }
                else
                    return new AccessToken
                    {
                        access_token = obj.access_token,
                        expires_in = GetCurrentTimeStamp()
                    };
            }
            else
            {
                var fileResult = SerializerHelper.LoadFromXML<AccessToken>(fileName);
                long ts = (GetCurrentTimeStamp() - fileResult.expires_in) / 1000;
                if (ts >= 7200)
                {
                    string respon = Program.HttpGetRequest(string.Format(URL_GetToken, Program.CorpId, Program.CorpSecret));
                    DingTalkRespond obj = JsonConvert.DeserializeObject<DingTalkRespond>(respon);
                    if (obj != null && obj.errcode == 0)
                    {
                        fileResult.access_token = obj.access_token;
                        fileResult.expires_in = GetCurrentTimeStamp();
                        SerializerHelper.SerializerToXML(fileName, fileResult);
                    }
                }
                return fileResult;
            }
        }

2)獲取企業(yè)總?cè)藬?shù)

/// <summary>
        /// 獲取公司總?cè)藬?shù)
        /// </summary>
        /// <returns></returns>
        private int GetFactoryEmployeeCount(AccessToken token)
        {
            int result = 0;
            string url = string.Format("https://oapi.dingtalk.com/user/get_org_user_count?access_token={0}&onlyActive=0", token.access_token);
            string jsonObj = Program.HttpGetRequest(url);
            var objResult = JsonConvert.DeserializeObject<DingTalkRespond>(jsonObj);
            if (objResult != null && objResult.errcode == 0)
                result = objResult.count;
            return result;
        }

3)獲取全體員工的考勤結(jié)果

  /// <summary>
        /// 獲取指定頁(yè)的考勤結(jié)果
        /// </summary>
        /// <param name="offset"></param>
        /// <returns></returns>
        private void GetAttendance(AccessToken token)
        {
            EmployeeAttendanceList.Clear();
            string url = string.Format("https://oapi.dingtalk.com/attendance/list?access_token={0}", token.access_token);
            int offset = 0;
            bool bHasMore = true;
            while (bHasMore)
            {
                var request = new AttendanceRequest
                {
                    workDateFrom = DateTime.Now.ToString("yyyy-MM-dd") + " 00:00:00",
                    workDateTo = DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss"),
                    limit = 50,
                    userIdList = null,
                    offset = offset * 50
                };
                string jsonRequest = JsonConvert.SerializeObject(request).Replace("null", "[]");
                string jsonResult = Program.PostJsonData(url, jsonRequest);
                var objResult = JsonConvert.DeserializeObject<DingTalkRespond>(jsonResult);
                if (objResult != null && objResult.errcode == 0)
                {
                    foreach (var item in objResult.recordresult)
                    {
                        if (!EmployeeAttendanceList.Any(a => a.id == item.id))
                            EmployeeAttendanceList.Add(item);
                    }
                    offset++;
                    bHasMore = objResult.hasMore;
                }
                else
                    break;
            }
            EmployeeAttendanceList = EmployeeAttendanceList.Where(a => a.checkType == "OnDuty").OrderBy(e => e.id).ToList();
        }

效果展示