批量查询打卡流水
POST
/open-apis/attendance/v1/user_flows/query
自建应用
如果只需获取打卡结果,而不需要详细的打卡数据,可使用“获取打卡结果”的接口。
错误码
HTTP状态码 | 错误码 | 描述 | 排查建议 |
---|---|---|---|
400 | 1220001 | 参数错误 | 请检查参数是否符合要求 |
400 | 1220002 | 租户不存在 | 请检查 tenant_access_token 是否正确 |
400 | 1220004 | 用户不存在或没有权限 | 请检查用户 ID 是否正确 |
400 | 1220005 | 没有权限 | 请前往考勤管理后台检查数据权限范围 |
500 | 1225000 | 系统错误 | 详见错误信息 |
500 | 1226500 | 打卡服务系统错误 | 详见错误信息 |
500 | 1227500 | 组织架构服务系统错误 | 详见错误信息 |
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.feishu.cn/open-apis/attendance/v1/user_flows/query?employee_type=employee_id' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
"user_ids": [
"abd754f7"
],
"check_time_from": "1566641088",
"check_time_to": "1566641088"
}'
响应示例响应示例
{
"code": 0,
"msg": "success",
"data": {
"user_flow_results": [
{
"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"
}
]
}
}
请求参数
Query 参数
employee_type
string
必需
示例值:
employee_id
include_terminated_user
string
可选
示例值:
true
Header 参数
Authorization
string
必需
默认值:
Bearer {{access_token}}
Content-Type
string
必需
默认值:
application/json; charset=utf-8
Body 参数application/json
返回响应
修改于 2023-01-28 08:58:59