任务概述

Warning: 注意： 请使用v2的任务接口任务v2接口功能概述，支持任务、清单、自定义分组、评论、自定义字段、附件等功能。本套接口即将废弃。

概述

飞书任务是一款轻量级的任务管理工具，拥有强大的协作能力。我们可以轻松地在会话等场景中快捷创建任务，也可以将感兴趣的任务分享给成员，或者关注一些感兴趣的任务。我们还可以围绕任务进行讨论，可以针对任务进行评论等。

GIF 演示

创建任务

给任务添加提醒时间、关注人、协作者

如何使用任务 API

1、为应用申请调用权限

若应用尚未申请任务 API 权限，需在开发者后台增加权限申请并提交审核。 企业自建应用需要企业管理员在管理后台审核通过；应用商店应用需要经过平台管理员审核、企业管理员在应用市场安装或升级。

权限描述 | 作用
| ---- | ------------------------- | ----------------------------------- | | 查看飞书任务详情 | 仅获取查询任务详情的权限
| 查看、创建、编辑和删除飞书任务 | 获取增删改查任务的权限

2、API鉴权

当前任务 API 支持 tenant_access_token 和 user_access_token 鉴权方式。 类型 | tenant_access_token | user_access_token
| ---- | ------------------------- | ----------------------------------- |-------- | | 描述 | 以应用身份调用任务接口，可对应用创建的任务数据进行增删改查，此时任务数据的owner为应用 | 以用户身份调用任务接口，等价于用户直接操作飞书任务中心
| 使用场景 | 应用需要有属于自己的任务数据时，使用此token
例如：
某项目管理应用中，需要为项目成员创建任务，任务owner为应用本身，可通过tenant_access_token调用任务接口数据 | 用户开发第三方任务应用，使用飞书的身份信息和飞书任务的能力，但希望提供与飞书不同的用户界面。 | 获取方式 | 企业安装应用后，应用可获取tenant_access_token
获取应用认证身份访问凭证 | 企业安装应用后，引导用户登录飞书，然后在用户授权下获取user_access_token
获取用户认证身份访问凭证 | 是否需要开启机器人能力 | 是 | 否

3、创建任务

通过创建任务接口可以应用的身份创建相应的任务，若想在自己的飞书-任务中看到该任务，需通过新增执行者或新增关注人接口添加自己为执行者或关注人。

任务支持AppLink

Tip: 任务支持 AppLink，可通过applink直接打开 Todo 详情页和 Todo Tab。

页面/场景	path	参数	备注
任务详情	/client/todo/detail	- guid: string [required] - ` authscene?:``1	2*MESSAGE* = 1;*PANO* = 2;传参使用数字，eg：xxxxx?authscene=2 - authid?: string -navigateStyle?: 'push'
任务中心	/client/todo/open	无	切换至 Todo Tab 示例：https://applink.feishu.cn/client/todo/open

资源 ID 字段说明

ID 名称	简介	自定义方式	获取方式
task_id	唯一标识一个任务的 ID	不可自定义，由服务器生成	接口获取：创建任务时返回该字段
reminder_id	唯一标识一个任务提醒时间的 ID	不可自定义，由服务器生成	接口获取：用 task_id 从查询提醒时间列表接口获取
follow_id	唯一标识一个任务关注人的 ID	不可自定义，由服务器生成	接口获取：用 task_id 从获取关注人列表接口获取
collaborator_id	唯一标识一个任务执行者的 ID	不可自定义，由服务器生成	接口获取：用 task_id 从获取执行者列表接口获取