获取用户审批通过数据

获取员工在某段时间内的请假、加班、外出和出差四种审批的通过数据。
请假的假期时长字段(interval)，暂未开放提供，待后续提供。

错误码

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

curl --location --request POST 'https://open.feishu.cn/open-apis/attendance/v1/user_approvals/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, "check_date_type": "PeriodTime", "status": 2, "check_time_from": "1566641088", "check_time_to": "1592561088" }'

{ "code": 0, "msg": "success", "data": { "user_approvals": [ { "user_id": "abd754f7", "date": "20210104", "outs": [ { "approval_id": "6737202939523236113", "uniq_id": "9496E43696967658A512969523E89870", "unit": 1, "interval": 28800, "start_time": "2021-01-04 09:00:00", "end_time": "2021-01-04 19:00:00", "i18n_names": { "ch": "中文描述", "en": "English description", "ja": "日本語の説明" }, "default_locale": "ch", "reason": "外出办事", "approve_pass_time": "2021-01-04 12:00:00", "approve_apply_time": "2021-01-04 11:00:00" } ], "leaves": [ { "approval_id": "6737202939523236113", "uniq_id": "6852582717813440527", "unit": 1, "interval": 28800, "start_time": "2021-01-04 09:00:00", "end_time": "2021-01-04 19:00:00", "i18n_names": { "ch": "中文描述", "en": "English description", "ja": "日本語の説明" }, "default_locale": "ch", "reason": "家里有事", "approve_pass_time": "2021-01-04 12:00:00", "approve_apply_time": "2021-01-04 11:00:00" } ], "overtime_works": [ { "approval_id": "6737202939523236113", "duration": 1.5, "unit": 1, "category": 2, "type": 1, "start_time": "2021-01-09 09:00:00", "end_time": "2021-01-10 13:00:00" } ], "trips": [ { "approval_id": "6737202939523236113", "start_time": "2021-01-04 09:00:00", "end_time": "2021-01-04 19:00:00", "reason": "培训", "approve_pass_time": "2021-01-04 12:00:00", "approve_apply_time": "2021-01-04 11:00:00" } ], "time_zone": "Asia/Shanghai" } ] } }

请求参数

Query 参数

employee_type

必需

请求体中的 user_ids 的员工工号类型，必选字段，可用值：【employee_id（员工 employee ID，即飞书管理后台 > 组织架构 > 成员与部门 > 成员详情中的用户 ID），employee_no（员工工号，即飞书管理后台 > 组织架构 > 成员与部门 > 成员详情中的工号）】，示例值："employee_id"

示例值:

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 列表

check_date_from

integer

查询的起始工作日

必需

check_date_to

integer

必需

查询的结束工作日，与 check_date_from 的时间间隔不超过30天

check_date_type

string

可选

查询依据的时间类型（不填默认依据PeriodTime）示例值："PeriodTime" 可选值有： PeriodTime：单据作用时间 CreateTime：单据创建时间（目前暂不支持） UpdateTime：单据状态更新时间（新增字段，对特定租户生效

status

integer

可选

查询状态（不填默认查询已通过状态）示例值：2 可选值有： 0：待审批 1：未通过 2：已通过 3：已取消 4：已撤回

check_time_from

string

可选

查询的起始时间，精确到秒的时间戳示例值："1566641088"

check_time_to

string

可选

查询的结束时间，精确到秒的时间戳示例值："1592561088"

示例

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

user_approvals

array [object {7}]

审批结果列表

必需

获取用户审批通过数据

错误码#

请求参数

返回响应

错误码