查询打卡流水

通过打卡记录 ID 获取用户的打卡流水记录。

错误码

HTTP状态码	错误码	描述	排查建议
400	1220001	参数错误	请检查参数是否符合要求
400	1220002	租户不存在	请检查 tenant_access_token 是否正确
400	1220004	用户不存在或没有权限	请检查用户 ID 是否正确
400	1220005	没有权限	请前往考勤管理后台检查数据权限范围
500	1225000	系统错误	详见错误信息
500	1226500	打卡服务系统错误	详见错误信息
500	1227500	组织架构服务系统错误	详见错误信息

curl --location --request GET 'https://open.feishu.cn/open-apis/attendance/v1/user_flows/6708236686834352397?employee_type=employee_id' \ --header 'Authorization: Bearer {{tenant_access_token}}' \ --header 'Authorization;'

{ "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" ], "check_result": "Invalid" } }

请求参数

Path 参数

user_flow_id

必需

打卡流水记录 ID，示例值："6708236686834352397"

示例值:

6708236686834352397

Query 参数

employee_type

必需

响应体中的 user_id 和 creator_id 的员工工号类型示例值："employee_id" 可选值有： open_id：开放 openID employee_id：员工 employee ID，即飞书管理后台 > 组织架构 > 成员与部门 > 成员详情中的用户 ID employee_no：员工工号，即飞书管理后台 > 组织架构 > 成员与部门 > 成员详情中的工号

示例值:

employee_id

Header 参数

Authorization

必需

示例值:

Bearer {{tenant_access_token}}

Content-Type

必需

示例值:

application/json

返回响应

🟢200成功

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

user_id

string

用户 ID

必需

creator_id

string

记录创建者 ID

必需

location_name

string

打卡位置名称信息

必需

check_time

string

必需

打卡时间，精确到秒的时间戳

comment

string

打卡备注

必需

record_id

string

打卡记录 ID

必需

longitude

number

打卡经度

必需

latitude

number

打卡纬度

必需

ssid

string

必需

打卡 Wi-Fi 的 SSID

bssid

string

必需

打卡 Wi-Fi 的 MAC 地址

is_field

boolean

是否为外勤打卡

必需

is_wifi

boolean

必需

是否为 Wi-Fi 打卡

type

string

必需

photo_urls

array[string]

打卡照片列表

必需

device_id

string

打卡设备 ID

必需

check_result

string

必需

错误码#

请求参数

返回响应

错误码