查询班表信息

支持查询多个用户的排班情况，查询的时间跨度不能超过 30 天。

错误码

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

curl --location --request POST 'https://open.feishu.cn/open-apis/attendance/v1/user_daily_shifts/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_daily_shifts": [ { "group_id": "6737202939523236110", "shift_id": "6753520403404030215", "month": 202101, "user_id": "abd754f7", "day_no": 21 } ] } }

请求参数

Query 参数

employee_type

必需

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

示例值:

employee_id

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

user_ids

array[string]

必需

employee_no 或 employee_id 列表示例值：["abd754f7"]

check_date_from

integer

必需

查询的起始工作日示例值：20190817

check_date_to

integer

必需

查询的结束工作日示例值：20190820

示例

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

user_daily_shifts

array [object {5}]

班表信息列表

必需

错误码#

请求参数

返回响应

错误码