Feishu Approval

飞书审批

通过 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 分钟刷新）

---

审批实例

创建实例:

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

---

审批任务

---

审批定义

---

审批抄送

---

审批评论

---

常见参数说明

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}"

---

最佳实践

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