滴答清单 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