SuperAPI AI 工具集

feishu-approval

通用与其它

查看项目

更新于 10-16 04:59

技能介绍

用途:该技能封装飞书审批(Approval)API,用于创建审批实例、查询审批状态,并处理审批任务、定义、抄送和评论等操作。Base URL 为 https://open.feishu.cn/open-apis/approval/v4。

主要能力:创建实例(POST /instances)、查询实例(GET /instances/{instance_id})、审批与撤回、转交、催办、获取实例列表与详情;任务列表与详情、审批任务、转交任务;获取审批定义列表、定义详情与表单字段;抄送列表与已读标记;添加与获取评论。实例状态包括 PENDING、APPROVED、REJECTED、CANCELED、DELETED。

使用方式:从 feishu_skills 根目录执行共享脚本获取 Token: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 分钟刷新。

示例:创建审批实例可调用 POST /instances,请求体包含 approval_code、user_id 和 form,form 必须为字符串化 JSON。常用参数包括 user_id_type(open_id 默认、user_id、union_id)和分页参数 page_size(默认 20,最大 100)、page_token。

限制:审批操作需审批人权限;创建实例和查询列表都需要指定 user_id;form 必须字符串化;大量数据需使用 page_token 分页。文档未提供收费、价格、平台支持范围等更多信息。