tomevault-io 飞书审批
通过 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_IDFEISHU_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_idunion_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
Converted and distributed by TomeVault — claim your Tome and manage your conversions.