查询打卡流水

通过打卡记录 ID 获取用户的打卡流水记录。返回信息主要包含：

• 用户id和创建者id
• 记录信息
• 打卡位置信息、时间信息
• 打卡方式信息
  • GPS 打卡：location_name（定位地址信息）
  • Wi-Fi 打卡：ssid（Wi-Fi名称）、bssid（mac地址）
  • 考勤机打卡：device_id（考勤机设备id）

对应页面功能打卡管理-打卡记录

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/attendance/v1/user_flows/:user_flow_id
HTTP Method	GET
接口频率限制	50 次/秒
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可	attendance:task 写入打卡数据 attendance:task:readonly 导出打卡数据

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 值格式："Bearer access_token" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token

路径参数

名称	类型	描述
user_flow_id	string	打卡流水记录 ID，获取方式：1）批量查询打卡流水记录 2）获取打卡结果 3）导入打卡流水记录 示例值："6708236686834352397"

查询参数

名称	类型	必填	描述
employee_type	string	是	响应体中的 user_id 和 creator_id 的员工ID类型。如果没有后台管理权限，可使用通过手机号或邮箱获取用户 ID 示例值：employee_id 可选值有： - employee_id: 员工 employee ID，即飞书管理后台 > 组织架构 > 成员与部门 > 成员详情中的用户 ID - employee_no: 员工工号，即飞书管理后台 > 组织架构 > 成员与部门 > 成员详情中的工号

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	user_flow	-
└ user_id	string	用户 ID，对应employee_type
└ creator_id	string	记录创建者 ID，对应employee_type
└ location_name	string	打卡位置名称信息
└ check_time	string	打卡时间，精确到秒的时间戳
└ comment	string	打卡备注
└ record_id	string	对应打卡流水记录ID
└ ssid	string	打卡 Wi-Fi 的 SSID
└ bssid	string	打卡 Wi-Fi 的 MAC 地址
└ is_field	boolean	是否为外勤打卡
└ is_wifi	boolean	是否为 Wi-Fi 打卡
└ type	int	记录生成方式，在开放平台调用时，此参数无效，内部值始终是7 可选值有： - 0: 用户打卡 - 1: 管理员修改 - 2: 用户补卡 - 3: 系统自动生成 - 4: 下班免打卡 - 5: 考勤机 - 6: 极速打卡 - 7: 考勤开放平台导入
└ photo_urls	string\[\]	打卡照片列表
└ device_id	string	打卡设备ID（只支持小程序打卡，导入时无效）
└ check_result	string	打卡结果，目前仅支持PendingApproval待生效。如需获取打卡结果请使用获取打卡结果 可选值有： - NoNeedCheck: 无需打卡 - SystemCheck: 系统打卡 - Normal: 正常 - Early: 早退 - Late: 迟到 - SeriousLate: 严重迟到 - Lack: 缺卡 - Invalid: 无效 - None: 无状态 - Todo: 尚未打卡
└ external_id	string	用户导入的外部打卡记录ID
└ idempotent_id	string	唯一幂等键

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "user_id": "abd754f7",
        "creator_id": "abd754f7",
        "location_name": "西溪八方城",
        "check_time": "1611476284",
        "comment": "上班打卡",
        "record_id": "6709359313699356941",
        "ssid": "b0:b8:67:5c:1d:72",
        "bssid": "b0:b8:67:5c:1d:72",
        "is_field": true,
        "is_wifi": true,
        "type": 7,
        "photo_urls": [
            "https://time.clockin.biz/manage/download/6840389754748502021"
        ],
        "device_id": "99e0609ee053448596502691a81428654d7ded64c7bd85acd982d26b3636c37d",
        "check_result": "Invalid",
        "external_id": "record_123",
        "idempotent_id": "****_***"
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
400	1220001	param is invalid	入参校验失败，请根据具体返回的信息检查入参。例如“employee_type invalid”代表人员类型异常。如仍无法解决可联系 技术支持
400	1220002	tenant_id is empty	请检查入参中的 tenant_access_token是否正确
400	1220004	param is invalid	请参考实际返回的错误信息排查问题。例如“user_id is not exist or does not have permission”代表入参传入的用户id不存在或者没有权限。如仍无法解决可联系 技术支持
400	1220005	没有权限	请前往考勤管理后台检查数据权限范围
500	1225000	param is invalid	请参考实际返回的错误信息排查问题。例如“internal server error”代表内部服务异常。如仍无法解决可联系 技术支持
500	1226500	历史错误码，不再使用	-
500	1227500	组织架构服务系统错误	班次服务异常错误码，请参考实际返回的错误信息排查问题。例如“[BatchGetLarkIDByOpenID] not find user larkID”代表没有找到对应lark uid。如仍无法解决可联系 技术支持
400	1220600	通用错误信息	通用错误信息包含多条，详细的错误信息以及处理建议可参见错误信息。