feishu-approval
飞书审批。创建审批实例、查询审批状态。
How do I install this agent skill?
npx skills add https://github.com/alextangson/feishu_skills --skill feishu-approvalIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill facilitates interaction with the Feishu Approval API, enabling users to create, query, and manage approval instances. It utilizes standard authentication practices, including environment variables for secrets and a local script for token management, communicating exclusively with official Feishu endpoints.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
- Runlayerpass
1 file scanned · No issues
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
飞书审批
通过 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
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/alextangson/feishu_skills/feishu-approval">View feishu-approval on skillZs</a>