Feishu Task

飞书任务。创建任务、更新任务、查询任务。 Use when this capability is needed.

tomevault-io 346bc60 2 files · 2.1 KB Updated

File contents

飞书任务

通过 Task API 管理任务。

Base URL: https://open.feishu.cn/open-apis/task/v2

认证与 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 端点 说明
创建任务 POST /tasks -
获取任务 GET /tasks/{task_guid} -
更新任务 PATCH /tasks/{task_guid} -
完成任务 POST /tasks/{task_guid}/complete -
删除任务 DELETE /tasks/{task_guid} -

创建任务:

{
  "summary": "任务标题",
  "description": "任务描述",
  "due": {"timestamp": "1770508800"},
  "members": [{"id": "ou_xxx", "role": "assignee"}]
}

最佳实践

  1. due 用秒级时间戳
  2. members 指定角色(assignee/follower)

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

tomevault-io/skills-registry/tree/main/alextangson--feishu-skills--feishu-task commit 346bc60b8e

Frequently asked questions

npx skillmds@latest add tomevault-io/feishu-task