查询所有班次

飞书人事管理后台中假勤设置-班次配置中的翻页查询所有班次功能，展示班次名称、打卡规则、弹性班次规则、休息规则等

请求

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

请求头

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

查询参数

名称	类型	必填	描述
page_size	int	否	分页大小 示例值：10 默认值：10 数据校验规则： - 取值范围：1 ～ 50
page_token	string	否	分页标记，第一次请求不填，表示从头开始遍历；分页查询结果还有更多项时会同时返回新的 page_token，下次遍历可采用该 page_token 获取查询结果 示例值：YrkvQ1wGaPVta45tkxuGiQ==

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ shift_list	shift\[\]	班次列表
└ shift_id	string	班次 ID
└ shift_name	string	班次名称
└ punch_times	int	打卡次数
└ sub_shift_leader_ids	string\[\]	无效字段，请勿使用
└ is_flexible	boolean	是否弹性打卡
└ flexible_minutes	int	弹性打卡时间，单位：分钟，设置【上班最多可晚到】与【下班最多可早走】时间，如果不设置flexible_rule则生效
└ flexible_rule	flexible_rule\[\]	弹性打卡时间设置
└ flexible_early_minutes	int	下班最多可早走，单位：分钟（上班早到几分钟，下班可早走几分钟）
└ flexible_late_minutes	int	上班最多可晚到，单位：分钟（上班晚到几分钟，下班须晚走几分钟）
└ no_need_off	boolean	不需要打下班卡
└ punch_time_rule	punch_time_rule\[\]	打卡规则
└ on_time	string	上班时间，格式为hh:mm
└ off_time	string	下班时间，格式为hh:mm。如果是第二天凌晨2点， 则为26:00
└ late_minutes_as_late	int	晚到多久记为迟到，单位：分钟
└ late_minutes_as_lack	int	晚到多久记为缺卡，单位：分钟
└ on_advance_minutes	int	最早多久可打上班卡，单位：分钟
└ early_minutes_as_early	int	早退多久记为早退，单位：分钟
└ early_minutes_as_lack	int	早退多久记为缺卡，单位：分钟
└ off_delay_minutes	int	最晚多久可打下班卡，单位：分钟
└ late_minutes_as_serious_late	int	晚到多久记为严重迟到，单位：分钟
└ no_need_on	boolean	true为需要打上班卡，false为不需要上班打卡。 注意和接口创建时的区别：接口创建时，no_need_on传参false表示需要打上班卡，true为不需要打上班卡
└ no_need_off	boolean	true为需要打下班卡，false为不需要下班打卡。 注意和接口创建时的区别：接口创建时，no_need_off传参false表示需要打下班卡，true为不需要打下班卡
└ late_off_late_on_rule	late_off_late_on_rule\[\]	晚走晚到规则（仅飞书人事企业版可用）
└ late_off_minutes	int	晚走多久，单位：分钟
└ late_on_minutes	int	晚到多久，单位：分钟
└ rest_time_rule	rest_rule\[\]	休息规则
└ rest_begin_time	string	休息开始
└ rest_end_time	string	休息结束
└ overtime_rule	overtime_rule\[\]	加班时段（仅飞书人事企业版可用）
└ on_overtime	string	开始时间
└ off_overtime	string	结束时间
└ day_type	int	日期类型，【是否弹性打卡 = true】时，不可设置为“休息日” 可选值：1：工作日 2：休息日 示例值：（默认值）1
└ overtime_rest_time_rule	rest_rule\[\]	班外休息规则
└ rest_begin_time	string	休息开始
└ rest_end_time	string	休息结束
└ late_minutes_as_serious_late	int	晚到多久记为严重迟到，单位：分钟（优先级比原有字段高）
└ shift_middle_time_rule	shift_middle_time_rule	半天分割规则（仅飞书人事企业版可用）
└ middle_time_type	int	半天分割类型 可选值有： - 0: 按全天班次时长（含休息）的中点分割 - 1: 按全天班次时长（不含休息）的中点分割 - 2: 按休息时间分割 - 3: 按固定时间点分割
└ fixed_middle_time	string	固定分割时间点（middle_time_type 为 3 时有效）
└ late_off_late_on_setting	late_off_late_on_setting	晚走次日晚到配置规则
└ late_off_base_on_time_type	int	当日晚走时间计算规则 可选值有： - 0: 弹性规则 - 1: 固定规则
└ late_on_base_on_time_type	int	次日晚到时间计算规则 可选值有： - 0: 固定规则 - 1: 弹性规则
└ page_token	string	分页标记，当 has_more 为 true 时，会同时返回新的 page_token，否则不返回 page_token
└ has_more	boolean	是否还有更多项

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "shift_list": [
            {
                "shift_id": "6919358778597097404",
                "shift_name": "早班",
                "punch_times": 1,
                "sub_shift_leader_ids": [
                    "456123"
                ],
                "is_flexible": false,
                "flexible_minutes": 60,
                "flexible_rule": [
                    {
                        "flexible_early_minutes": 60,
                        "flexible_late_minutes": 60
                    }
                ],
                "no_need_off": true,
                "punch_time_rule": [
                    {
                        "on_time": "9:00",
                        "off_time": "18:00",
                        "late_minutes_as_late": 30,
                        "late_minutes_as_lack": 60,
                        "on_advance_minutes": 60,
                        "early_minutes_as_early": 30,
                        "early_minutes_as_lack": 60,
                        "off_delay_minutes": 60,
                        "late_minutes_as_serious_late": 40,
                        "no_need_on": true,
                        "no_need_off": true
                    }
                ],
                "late_off_late_on_rule": [
                    {
                        "late_off_minutes": 60,
                        "late_on_minutes": 30
                    }
                ],
                "rest_time_rule": [
                    {
                        "rest_begin_time": "13:00",
                        "rest_end_time": "14:00"
                    }
                ],
                "overtime_rule": [
                    {
                        "on_overtime": "9:00",
                        "off_overtime": "18:00"
                    }
                ],
                "day_type": 1,
                "overtime_rest_time_rule": [
                    {
                        "rest_begin_time": "13:00",
                        "rest_end_time": "14:00"
                    }
                ],
                "late_minutes_as_serious_late": 40,
                "shift_middle_time_rule": {
                    "middle_time_type": 0,
                    "fixed_middle_time": "12:00"
                },
                "late_off_late_on_setting": {
                    "late_off_base_on_time_type": 0,
                    "late_on_base_on_time_type": 0
                }
            }
        ],
        "page_token": "YrkvQ1wGaPVta45tkxuGiQ==",
        "has_more": true
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
400	1220001	param is invalid	入参校验失败，请根据具体返回的信息检查入参。例如“employee_type invalid”代表人员类型异常。如仍无法解决可联系 技术支持
400	1220002	tenant_id is empty	请检查入参中的 tenant_access_token是否正确
500	1225000	param is invalid	请参考实际返回的错误信息排查问题。例如“internal server error”代表内部服务异常。如仍无法解决可联系 技术支持
500	1226000	param is invalid	班次服务异常错误码，请参考实际返回的错误信息排查问题。例如“internal server error”代表内部服务异常。如仍无法解决可联系 技术支持
400	1226003	param is invalid	请参考实际返回的错误信息排查问题。例如“default shift are not allowed to change.”代表默认班次不能修改。如仍无法解决可联系 技术支持
400	1220600	通用错误信息	通用错误信息包含多条，详细的错误信息以及处理建议可参见 错误信息