服务端 API/考勤打卡/考勤记录/批量查询打卡流水记录 # 批量查询打卡流水记录 批量查询授权内员工的实际打卡流水记录。例如，企业给一个员工设定的班次是上午 9 点和下午 6 点各打一次上下班卡，但是该员工在这期间打了多次卡，该接口会把所有的打卡记录都返回。 **注意事项**：如果只需获取打卡结果，而不需要详细的打卡数据，可使用“获取打卡结果”的接口。 ## 请求 基本 |   ---|--- HTTP URL | https://open.larksuite.com/open-apis/attendance/v1/user_flows/query HTTP Method | POST 支持的应用类型 | Custom App 权限要求
**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 导出打卡数据(attendance:task:readonly) ### 请求头 名称 | 类型 | 必填 | 描述 ---|---|---|--- Authorization | string | 是 | `tenant_access_token`
**值格式**："Bearer `access_token`"
**示例值**："Bearer t-7f1bcd13fc57d46bac21793a18e560"
[了解更多：获取与使用access_token](https://open.larksuite.com/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM) Content-Type | string | 是 | **固定值**："application/json; charset=utf-8" ### 查询参数 名称 | 类型 | 必填 | 描述 ---|---|---|--- employee_type | string | 是 | 请求体中的 user_ids 和响应体中的 user_id 的员工工号类型
**示例值**："employee_id"
**可选值有**：
- `employee_id`：员工 employee ID，即Lark管理后台 > 组织架构 > 成员与部门 > 成员详情中的用户 ID
- `employee_no`：员工工号，即Lark管理后台 > 组织架构 > 成员与部门 > 成员详情中的工号 include_terminated_user | boolean | 否 | 由于新入职用户可以复用已离职用户的employee_no/employee_id。如果true，返回employee_no/employee_id对应的所有在职+离职用户数据；如果false，只返回employee_no/employee_id对应的在职或最近一个离职用户数据
**示例值**：true ### 请求体 名称 | 类型 | 必填 | 描述 ---|---|---|--- user_ids | string\[\] | 是 | employee_no 或 employee_id 列表，长度不超过 50
**示例值**：[ "abd754f7"] check_time_from | string | 是 | 查询的起始时间，时间戳
**示例值**："1566641088" check_time_to | string | 是 | 查询的结束时间，时间戳
**示例值**："1566641088" ### 请求体示例 ```json { "user_ids": [ "abd754f7" ], "check_time_from": "1566641088", "check_time_to": "1566641088" } ``` ## 响应 ### 响应体 名称 | 类型 | 描述 ---|---|--- code | int | 错误码，非 0 表示失败 msg | string | 错误描述 data | \- | \-  ∟ user_flow_results | user_flow\[\] | 打卡记录列表   ∟ user_id | string | 用户 ID   ∟ creator_id | string | 记录创建者 ID   ∟ location_name | string | 打卡位置名称信息   ∟ check_time | string | 打卡时间，精确到秒的时间戳   ∟ comment | string | 打卡备注   ∟ record_id | string | 打卡记录 ID   ∟ longitude | float | 打卡经度   ∟ latitude | float | 打卡纬度   ∟ ssid | string | 打卡 Wi-Fi 的 SSID   ∟ bssid | string | 打卡 Wi-Fi 的 MAC 地址   ∟ is_field | boolean | 是否为外勤打卡   ∟ is_wifi | boolean | 是否为 Wi-Fi 打卡   ∟ type | int | 记录生成方式
**可选值有**：
- `0`：用户打卡
- `1`：管理员修改
- `2`：用户补卡
- `3`：系统自动生成
- `4`：下班免打卡
- `5`：考勤机
- `6`：极速打卡
- `7`：考勤开放平台导入   ∟ photo_urls | string\[\] | 打卡照片列表   ∟ device_id | string | 打卡设备 ID ### 响应体示例 ```json { "code": 0, "msg": "success", "data": { "user_flow_results": [ { "user_id": "abd754f7", "creator_id": "abd754f7", "location_name": "Xixi Bafang City", "check_time": "1611476284", "comment": "Clock in", "record_id": "6709359313699356941", "longitude": 30.28991, "latitude": 120.04513, "ssid": "b0:b8:67:5c:1d:72", "bssid": "b0:b8:67:5c:1d:72", "is_field": true, "is_wifi": true, "type": 0, "photo_urls": [ "https://time.clockin.biz/manage/download/6840389754748502021" ], "device_id": "99e0609ee053448596502691a81428654d7ded64c7bd85acd982d26b3636c37d" } ] } } ``` ### 错误码 HTTP状态码 | 错误码 | 描述 | 排查建议 ---|---|---|--- 400 | 1220001 | 参数错误 | 请检查参数是否符合要求 400 | 1220002 | 租户不存在 | 请检查 tenant_access_token 是否正确 400 | 1220004 | 用户不存在或没有权限 | 请检查用户 ID 是否正确 400 | 1220005 | 没有权限 | 请前往[考勤管理后台](https://oa.larksuite.com/attendance/manage/member/list)检查数据权限范围 500 | 1225000 | 系统错误 | 详见错误信息 500 | 1226500 | 打卡服务系统错误 | 详见错误信息 500 | 1227500 | 组织架构服务系统错误 | 详见错误信息