详情参阅官方文档 Things URL Scheme - Things Support - Cultured Code
相关设置
启用URL
- Things - 设置 - 常规 - 高级
- Things URL Schemes - 启用 - on
获取ＩＤ
- 项目的下方的「•••」或右上角的「Ⓥ」
- 共享 - 复制链接
数值类型
-
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:3021:30
-
date time string
- date string @ time string
描述 语法 某日晚上六点 2018-02-25@14:00 今天下午六点 evening@6pm 明天下午六点 tomorrow@6pm -
boolean
- 布尔值
truefalse
- 布尔值
-
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
- data
网友评论