飞书审批

通过 Approval API 创建和查询审批实例。

Base URL: https://open.feishu.cn/open-apis/approval/v4

认证与 Token 获取

从 feishu_skills 根目录执行共享脚本：

TOKEN="$(./scripts/get_feishu_token.sh)"

请求头统一使用 Authorization: Bearer ${TOKEN}。

如果业务接口返回 token 无效、过期或 401，强制刷新后仅重试一次原请求：

TOKEN="$(./scripts/get_feishu_token.sh --force-refresh)"

环境变量:

FEISHU_APP_ID
FEISHU_APP_SECRET

本地缓存: ./.feishu_token_cache.json（未过期直接复用，默认提前 5 分钟刷新）

审批实例

API	端点	方法	请求体示例	说明
创建实例	`/instances`	POST	`{"approval_code":"7C46...","user_id":"ou_xxx","form":"{\"widget1\":\"value1\"}"}`	发起审批
查询实例	`/instances/{instance_id}`	GET	-	获取审批状态
审批操作	`/instances/{instance_id}/approve`	POST	`{"comment":"同意","task_id":"xxx"}`	同意/拒绝审批
撤回审批	`/instances/{instance_id}/cancel`	POST	`{"user_id":"ou_xxx"}`	申请人撤回
转交审批	`/instances/{instance_code}/transfer`	POST	`{"user_id":"ou_xxx","transfer_user_id":"ou_yyy","comment":"转交"}`	转交给他人
催办审批	`/instances/{instance_id}/urge`	POST	-	发送催办提醒
获取实例列表	`/instances`	GET	查询参数：`page_size=50&page_token=xxx&user_id=ou_xxx`	支持筛选参数（分页）
查询实例详情	`/instances/detail`	POST	`{"instance_code":"xxx"}`	查询完整详情

创建实例:

{
  "approval_code": "7C468A54-8745-2245-9675-08B7C63E7A85",
  "user_id": "ou_xxx",
  "form": "{\"widget1\":\"value1\"}"
}

审批任务

API	端点	方法	请求体示例	说明
获取任务列表	`/tasks`	GET	-	查询待办任务
获取任务详情	`/tasks/{task_id}`	GET	-	查询任务详情
审批任务	`/tasks/{task_id}/approve`	POST	`{"comment":"同意"}`	处理审批任务
转交任务	`/tasks/{task_id}/transfer`	POST	`{"transfer_user_id":"ou_xxx"}`	转交任务

审批定义

API	端点	方法	请求体示例	说明
获取定义列表	`/approvals`	GET	-	查询所有审批模板
获取定义详情	`/approvals/{approval_code}`	GET	-	查询模板详情
获取定义表单	`/approvals/{approval_code}/forms`	GET	-	查询表单字段定义

审批抄送

API	端点	方法	请求体示例	说明
获取抄送列表	`/cc`	GET	-	查询抄送我的审批
已读抄送	`/cc/{instance_id}/read`	POST	-	标记抄送已读

审批评论

API	端点	方法	请求体示例	说明
添加评论	`/instances/{instance_id}/comments`	POST	`{"content":"评论内容","user_id":"ou_xxx"}`	添加审批评论
获取评论	`/instances/{instance_id}/comments`	GET	-	查询评论列表

常见参数说明

user_id_type: 用户 ID 类型

open_id（默认）
user_id
union_id

分页参数:

page_size: 每页数量（默认 20，最大 100）
page_token: 分页标记

实例状态:

PENDING: 审批中
APPROVED: 已通过
REJECTED: 已拒绝
CANCELED: 已撤回
DELETED: 已删除

测试示例

获取审批定义列表:

curl -X GET "https://open.feishu.cn/open-apis/approval/v4/approvals?page_size=10" \
  -H "Authorization: Bearer ${TOKEN}"

创建审批实例:

curl -X POST "https://open.feishu.cn/open-apis/approval/v4/instances" \
  -H "Authorization: Bearer ${TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "approval_code": "7C468A54-8745-2245-9675-08B7C63E7A85",
    "user_id": "ou_xxx",
    "form": "{\"widget1\":\"请假3天\"}"
  }'

查询实例列表:

curl -X GET "https://open.feishu.cn/open-apis/approval/v4/instances?page_size=20&user_id=ou_xxx" \
  -H "Authorization: Bearer ${TOKEN}"

最佳实践

先获取审批定义（确认 form 字段）
form 必须字符串化 JSON
审批操作需审批人权限
分页查询：大量数据用 page_token 分页
user_id 必填：创建实例和查询列表都需要指定 user_id

feishu-approval