按名称查询考勤组

按考勤组名称查询考勤组摘要信息。查询条件支持名称精确匹配和模糊匹配两种方式。查询结果按考勤组修改时间 desc 排序，且最大记录数为 10 条。
该接口依赖的数据和考勤组主数据间存在数据同步延时（正常数据同步 2 秒以内），因此在使用该接口时需注意评估数据延迟潜在风险。

错误码

HTTP状态码	错误码	描述	排查建议
400	1220001	参数错误	请检查参数是否符合要求
400	1220002	租户不存在	请检查 tenant_access_token 是否正确

curl --location --request POST 'https://open.feishu.cn/open-apis/attendance/v1/groups/search' \ --header 'Authorization;' \ --header 'Content-Type: application/json' \ --data-raw '{ "group_name": "考勤组1" }'

请求参数

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

group_name

string

必需

考勤组名称示例值："考勤组1"

exactly_matched

boolean

必需

是否精准匹配，默认为 false：模糊匹配；true：精准匹配示例值：true

示例

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

group_list

array [object {2}]

考勤组列表

必需

按名称查询考勤组

错误码#

请求参数

返回响应

错误码