Things URL Schemes

详情参阅官方文档 Things URL Scheme - Things Support - Cultured Code

相关设置

启用URL

1. Things - 设置 - 常规 - 高级
2. Things URL Schemes - 启用 - on

获取ＩＤ

1. 项目的下方的「•••」或右上角的「Ⓥ」
2. 共享 - 复制链接

数值类型

• string

  • 最大未编码字符串长度为 4000 个

• date string

  • 自然日期语言的字符串（只支持英文）
  • 使用以下两值则忽略时间组件
    • 任何时间 anytime
    • 指定一天 someday

  描述	语法
  今天	today
  今晚	evening/eve
  明天	tomorrow/tom
  周一	monday/mon
  下周一	next monday
  本周末	this weekend
  下周末	next weekend
  指定日	yyyy-mm-dd
  25号	25nd

• time string

  • 描述当地时区的时间的字符串
  • 例如 9:30 21:30

• date time string

  • date string @ time string

  描述	语法
  某日晚上六点	2018-02-25@14:00
  今天下午六点	evening@6pm
  明天下午六点	tomorrow@6pm

• boolean

  • 布尔值 true false

• JSON string

  • JSON 格式的字符串 更多详详情参阅

操作支持

添加（add & add-project）

• 概述

通过 add 或 add-project 可以快速添加待办任务或项目，也可以设置简单模板，或可通过第三方应用动态创建新项目。

所有参数都是可选的。如果不指定 when 或 list-id，事项将被添加到收件箱。

命令	描述
add	添加一个或多个独立的事项
add-project	添加一个可参与构建的项目

• 语法

things:///add?参数=值&参数=值&参数=值…
things:///add-project?参数=值&参数=值&参数=值…

• 参数重叠表

描述	参数	add	add-project
区内待办	to-dos=项目内建待办名	✕	✓
已有区域	area-id=目标区域ID	✕	✓
已有区域	area=目标区域名	✕	✓
单个标题	title=待办或项目的标题	✓	✓
批量标题	titles=标题%0A标题	✓	✕
万字备注	notes=备注%0A备注	✓	✓
日期时间	when=英文日期时间	✓	✓
截止日期	deadline=最后到期日	✓	✓
已有标签	tags=标签名,标签名	✓	✓
已有项目	list=目标项目或区域名	✓	✓
已有项目	list-id=目标项目或区域ID	✓	✓
已有分类	heading=分类标题名	✓	✕
标记完成	completed=true	✓	✓
标记取消	canceled=true	✓	✓
弹窗确认	show-quick-entry=true	✓	✕
百条清单	checklist-items=清单%0A	✓	✕
高亮显示	reveal=true	✓	✓
回调响应	x-success=x-things-id	✓	✓

回调 等待获取新任务的标识符。点击包含在深层链接中的 x-success=x-things-id 并等待该项目成功完成创建后，在原始应用中返回的新项目ID。

• 示例

批量任务 things:///add?titles=纸巾%0a牛奶%0a草莓&list=购物
今日待办 things:///add?when=today&show-quick-entry=true
附加标签 things:///add?tags=每日&show-quick-entry=true
指定标题 things:///add?title=测试&heading=每周&list=周期事件
已完成项 things:///add?title=标题&completed=true
已取消项 things:///add?title=标题&canceled=true
弹窗确认 things:///add?title=标题&show-quick-entry=true
待办清单 things:///add?title=标题&checklist-items=列表%0A列表%0A列表

今日项目 things:///add-project?title=项目标题&when=today
项目清单 things:///add-project?title=月评&to-dos=待办%0A待办%0A待办
区域项目 things:///add-project?title=项目标题&area=目标区域名
期限项目 things:///add-project?title=建议&deadline=December%2031&area-id=F00A4075-0CA6-4A7F-88C6-CC8B4F1712FC

过滤（show & search）

注意：查看待办任务不能使用 query 参数，要改用 id 参数或 search 命令。

• 命令

命令	描述
show	浏览内置过滤器，可使用标签筛选
search	通过搜索关键词搜索待办事项

• 过滤器

收件箱：inbox
　今日：today
　计划：upcoming
　随时：anytime
　某天：someday
日志簿：logbook
待办id：例如 8796CC16E-92FA-4809-9A26-36194985E87B

• 参数重叠表

选项	描述	参数	show	search
必选	过滤	id=过滤器名或待办事项ID	✓
必选	项目	query=区域/项目/标签/过滤器名	✓	✓
可选	标签	filter=逗号分隔的标签标题	✓

• 示例

弹框搜索 things:///search
搜索文本 things:///search?query=关键词

今日 things:///show?id=today
到期 things:///show?id=Today&filter=紧急
待办 things:///show?id=8796CC16E-92FA-4809-9A26-36194985E87B
项目 things:///show?id=9096CC16E-92FA-4809-9A26-36194985E44A
项目 things:///show?query=项目名或区域名
标签 things:///show?query=项目名&filter=标签名
闲时 things:///show?id=Anytime&filter=闲时,家里

版本 version

Things 应用程序和 URL Schemes 的版本

things:///version

返回参数	x-success
Things URL Schemes 的版本	x-things-scheme-version
应用程序的内部版本号	x-things-client-version

开发 add-json

• 概述

还有一些基于JSON 的高级添加命令，可以更好地控制项目和待办事项导入事物。此命令旨在供应用程序开发人员或熟悉脚本或编程的其他人员使用。

我们创建了一组 Swift 帮助器类，您可以使用它们更轻松地生成此命令所需的JSON。

从Things JSON Coder GitHub存储库获取代码

通过 JSON 将各种类型的项目添加到 Things 中，高级用户可以根据自己的愿望定制尽可能多的复杂功能）。JSON 的导入功能可以创建项目模板，以便共享或下载其他人的项目。

此外，JSON 支持可以让 MindNode 等第三方开发人员实现深度自动化，他们可以将数据导出并导入到 Things 中。Cultured Code 的团队甚至增加了代码示例。

• 语法

things:///add-json?data=###
things:///add-json?data=###&reveal=true

• 参数
  • data
    • JSON字符串
    • JSON应该是一个包含 to-do 和 project 对象的数组
  • reveal
    • 布尔，默认 false
    • 是否浏览并显示新创建的待办事项或项目
    • 若创建了多个项目，则会显示第一个项目
  • x-things-ids
    • 返回参数 x-success
    • JSON 字符串
    • 创建的顶级 JSON 数组中指定的待办事项和项目的 ID 数组
    • 不会返回在项目中创建的待办事项的ID