滴答清单 iOS URL Scheme

如果你想要将滴答清单与其他应用程序集成,可以尝试使用 URL Scheme 来定制工作流。

使用 URL Scheme 可以从其他应用发送指令到滴答清单,配合 iOS “捷径” 等第三方应用,您可以进行一些自动化操作。

滴答清单能执行以下指令,比如:

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

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

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-07T01:20:00.000+0000
  • endDate:结束时间(非必填)
    • 格式:2018-05-07T01:20:00.000+0000
  • 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

举例:添加任务“明天下午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,则滴答清单会返回以下参数,以供下一个 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

工作流

如果您正在使用系统「捷径」app 或者第三方应用「Drafts」app,我们已经为您准备了一些常用的工作流,请您点击以下链接,即可保存到您的「捷径」app 或者「Drafts」app 中。

捷径

1、保存剪贴板的内容(首行:任务标题;其他行:文本内容)

2、保存剪贴板的内容(首行:任务标题;其他行:子任务)

3、保存剪贴板的内容(每一行都是独立的任务)

4、编辑剪贴板的内容再保存(首行:任务标题;其他行:文本内容)

5、触发全局输入框,输入内容后保存(首行:任务标题;其他行:文本内容)

6、触发全局输入框,输入内容后保存(首行:任务标题;其他行:子任务)

7、触发全局输入框,输入内容后保存(每一行都是独立的任务)

8、在滴答清单搜索剪贴板的内容

9、快速打开“今天”

Drafts

1、批量添加任务到滴答清单

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

3、添加任务和子任务到滴答清单