任务概述

概述

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

若应用尚未申请任务 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 获取用户认证身份访问凭证
是否需要开启机器人能力	是	否

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

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