获取打卡结果
POST
/open-apis/attendance/v1/user_tasks/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_tasks/query?employee_type=employee_id' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
"user_ids": [
"abd754f7"
],
"check_date_from": 20190817,
"check_date_to": 20190820
}'
响应示例响应示例
{
"code": 0,
"msg": "success",
"data": {
"user_task_results": [
{
"result_id": "6709359313699356941",
"user_id": "abd754f7",
"employee_name": "张三",
"day": 20190819,
"group_id": "6737202939523236110",
"shift_id": "6753520403404030215",
"records": [
{
"check_in_record_id": "6709359313699356941",
"check_in_record": {
"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"
},
"check_out_record_id": "6709359313699356942",
"check_out_record": {
"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"
},
"check_in_result": "SystemCheck",
"check_out_result": "SystemCheck",
"check_in_result_supplement": "None",
"check_out_result_supplement": "None",
"check_in_shift_time": "1609722000",
"check_out_shift_time": "1609754400"
}
]
}
],
"invalid_user_ids": [
"abd754f7"
],
"unauthorized_user_ids": [
"abd754f7"
]
}
}
请求参数
Query 参数
employee_type
必需
示例值:
employee_id
ignore_invalid_users
string
可选
示例值:
true
include_terminated_user
string
可选
示例值:
true
Header 参数
Authorization
string
必需
默认值:
Bearer {{access_token}}
Content-Type
string
必需
默认值:
application/json; charset=utf-8
Body 参数application/json