滴答清单 iOS 快捷指令和 URL Scheme

如果你想要将滴答清单与其他应用程序集成，可以尝试使用快捷指令或 URL Scheme 来定制工作流。使用 URL Scheme 可以从其他应用发送指令到滴答清单，配合 iOS 系统「快捷指令」等第三方应用，您可以进行一些自动化操作。

常用工作流

如果您正在使用系统「快捷指令」或者第三方应用「Drafts」，我们已经为您准备了一些常用指令，您可以点击以下链接保存。

一、iOS 快捷指令

从剪贴板添加任务

• 从剪贴板添加任务（文本模式） （剪贴板第一行：任务标题；其他行：任务内容）

• 从剪贴板添加任务（检查事项模式） （剪贴板第一行：任务标题；其他行：检查事项）

• 从剪贴板批量添加多个任务 （剪贴板每一行都是独立任务）

全局快速添加任务

• 快速添加任务（文本模式） （第一行：任务标题；其他行：任务内容）

• 快速添加任务（检查事项模式） （第一行：任务标题；其他行：检查事项）

• 快速添加多个任务 （每一行都是独立任务）

其他快捷操作

• 查看今天的任务

• 查看指定清单内的任务

• 查看日历月视图

• 开始番茄

P.S. 您可以直接在「快捷指令」应用中，搜索「滴答清单」，获取更多指令。目前我们一共提供 5 种不同类型的指令：添加任务；打开清单/智能清单/标签；打开日历视图；开始番茄；进行打卡。

二、Drafts

• 批量添加任务到滴答清单

• 添加任务和文本内容到滴答清单

• 添加任务和检查事项到滴答清单

URL Scheme

除上述快捷指令外，您也可以根据实际需要，使用我们提供的 URL Scheme 自由设置。

目前滴答清单的 URL Scheme 能执行以下指令，比如：

• 添加任务：添加一个叫“购买鸡蛋”的任务
• 显示智能清单：显示“今天”智能清单
• 搜索任务：搜索包含“开会”的任务

这些指令将通过特定的链接来传达，链接的格式为：

ticktick://v1/command?parameter1=value1&parameter2=value2&…

打开这些链接将启动滴答清单并执行指令。其中：

• command 表示指令的类型，目前滴答清单支持“添加任务”、“显示”、“搜索”三种指令
• parameter 表示参数，比如添加一个任务，参数包括“任务标题”、“开始时间”、“任务内容”等
• value 表示具体的值，比如参数“任务标题”的具体值是“购买鸡蛋”。

举个例子，如果你想要显示“今天”智能清单，这个链接就应该是下方这种格式：

ticktick://v1/show?smartlist=today

接下来，你将了解到三种指令的具体使用方式。

一、“添加任务”指令

“添加任务”的指令支持 x-call-back 的回调约定，即当你通过“添加任务”的指令打开滴答清单应用并成功添加任务后，可以回到发起指令的应用程序中。目前滴答清单支持三种回调：x-success, x-error, x-cancel。

因此，“添加任务”指令的特定链接格式如下：

ticktick://x-callback-url/v1/add_task?parameter1=value1&parameter2=value2&…&x-success={{下一个app的scheme}}

“添加任务”的指令包括以下参数：

• title：任务标题（必填）
• startDate：开始时间
  • 格式（带时区）：2018-05-07T18:00:00.000+0000
  • 格式（不带时区）：2018-05-07T18:00:00.000（注意：不带时区时，会按照设备的当前时区来解析）
• endDate：结束时间
  • 格式（带时区）：2018-05-07T01:20:00.000+0000
  • 格式（不带时区）：2018-05-07T01:20:00.000（注意：不带时区时，会按照设备的当前时区来解析）
• allDay：是否是全天任务
  • 是全天任务时=true；不是全天任务时=false
  • startDate 或 endDate 有值时必填
• priority：优先级
  • 无优先级=0；低优先级=1；中优先级=3；高优先级=5
  • 默认=0
• content：任务内容
• list：所属清单名
  • 默认=inbox
• subtasks：检查事项

举例：添加任务“购买鸡蛋”

ticktick://x-callback-url/v1/add_task?title=buy%20some%20eggs&x-success={{下一个app的scheme}}

举例：添加任务“明天下午6点购买鸡蛋”到“购物”清单

ticktick://x-callback-url/v1/add_task?title=buy%20some%20eggs&startDate=2018-05-08T18:00:00.000+0000&allDay=false&list=shopping&x-success={{下一个app的scheme}}

添加任务成功后，若回调的是 x-success，则滴答清单会返回以下参数，以供下一个 x-callback-url 指令调用：

• title：任务标题
• taskID：任务的唯一标识

二、“显示”指令

“显示”指令的特定链接格式如下：

ticktick://v1/show?parameter=value

“显示”的指令包括以下参数：

• smartlist：智能清单名（必填）
  • 所有=all
  • 今天=today
  • 明天=tomorrow
  • 最近7天=next_7_days
  • 分配给我=assign_to_me

举例：显示“今天”智能清单

ticktick://v1/show?smartlist=today

三、“搜索”指令

“搜索”指令的特定链接格式如下：

ticktick://v1/search?parameter=value

“搜索”的指令包括以下参数：

• keyword：关键字（必填）

举例：搜索所有包含关键字“shopping”的任务

ticktick://v1/search?keyword=shopping