钉钉获取过去公司或者企业的所有员工的考勤记录接口？

要获取过去公司或企业所有员工的考勤记录，可以通过钉钉开放平台提供的相关API接口实现。以下是详细的步骤和配置说明：

1. 确认权限配置

在调用钉钉考勤相关的API之前，需要确保应用已具备以下权限： - 通讯录个人信息读权限：用于获取员工的基本信息。 - 考勤数据读取权限：用于获取员工的考勤记录。

具体权限配置如下： 1. 登录钉钉开放平台，进入“应用开发” > “企业内部应用”。 2. 选择目标应用，进入“权限管理”页面。 3. 设置权限范围为“全部员工”，并开通以下权限点： - Contact.User.Read（通讯录个人信息读权限） - qyapi_base（调用企业API基础权限）

2. 获取企业AccessToken

调用钉钉API前，需要先获取企业的access_token，这是调用所有企业级API的必要凭证。

请求方式

• URL: https://oapi.dingtalk.com/gettoken
• 方法: GET

请求参数

返回结果

{
  "errcode": 0,
  "errmsg": "ok",
  "access_token": "your_access_token",
  "expires_in": 7200
}

3. 调用考勤记录查询接口

钉钉提供了专门的考勤记录查询接口，可以获取指定时间段内所有员工的考勤数据。

接口地址

• URL: https://oapi.dingtalk.com/attendance/list
• 方法: POST

请求参数

示例请求

{
  "workDateFrom": "2023-01-01 00:00:00",
  "workDateTo": "2023-01-31 23:59:59",
  "offset": 0,
  "limit": 50
}

返回结果

{
  "errcode": 0,
  "errmsg": "ok",
  "recordresult": [
    {
      "userId": "zhangsan",
      "checkType": "OnDuty",
      "checkTime": "2023-01-01 08:30:00",
      "locationResult": "Normal",
      "baseCheckTime": "2023-01-01 09:00:00"
    },
    {
      "userId": "lisi",
      "checkType": "OffDuty",
      "checkTime": "2023-01-01 18:00:00",
      "locationResult": "Normal",
      "baseCheckTime": "2023-01-01 18:00:00"
    }
  ]
}

4. 注意事项

• 分页处理：如果员工数量较多，需通过offset和limit参数进行分页查询，确保获取完整的考勤记录。
• 时间范围限制：单次查询的时间范围不能超过31天，建议按月分段查询。
• 权限校验：确保应用已获得足够的权限，否则可能导致接口调用失败。
• 数据隐私：考勤数据涉及员工隐私，请妥善保管和使用。

5. 示例代码

以下是一个基于Python的示例代码，展示如何调用上述接口获取考勤记录：

import requests

# 获取AccessToken
def get_access_token(appkey, appsecret):
    url = "https://oapi.dingtalk.com/gettoken"
    params = {"appkey": appkey, "appsecret": appsecret}
    response = requests.get(url, params=params)
    return response.json().get("access_token")

# 查询考勤记录
def get_attendance_records(access_token, start_date, end_date):
    url = "https://oapi.dingtalk.com/attendance/list"
    headers = {"Content-Type": "application/json"}
    data = {
        "workDateFrom": start_date,
        "workDateTo": end_date,
        "offset": 0,
        "limit": 50
    }
    response = requests.post(url, headers=headers, json=data, params={"access_token": access_token})
    return response.json()

# 主函数
if __name__ == "__main__":
    appkey = "your_appkey"
    appsecret = "your_appsecret"
    start_date = "2023-01-01 00:00:00"
    end_date = "2023-01-31 23:59:59"

    access_token = get_access_token(appkey, appsecret)
    records = get_attendance_records(access_token, start_date, end_date)
    print(records)

通过以上步骤，您可以成功获取公司或企业所有员工的考勤记录。请根据实际需求调整时间范围和分页参数，以确保数据完整性和准确性。