Things 3作为一款简约而强大的GTD App，其内置的URL Scheme打破了传统GTD软件与其他生产力软件之间的壁垒。只需要一个链接，就可以完成软件之间的相互通讯。
Things 3同时意识到URL Scheme的安全需求，以明文auth-token的形式进行操作提权。没有过于复杂的API，简约而不简单。
因GFW限制，此处转载URL Scheme的开发文档，供以查阅。
The URL scheme lets pro users and developers of other apps send commands to Things. This page explains how it works.
Here are some examples of commands that Things understands:
- Create a new to-do named “Buy milk”.
- Show the Today list.
- Show all to-dos tagged with “Errand”.
- Search all to-dos for “shipping address”.
There’s also a powerful JSON-based command that lets you create entire projects, together with all their notes, headings, and to-dos.
You can find the full documentation for each supported command further below. If you want to jump right in, here’s a little link builder tool to get you started. Simply fill out some of the fields and the corresponding link will be created for you on the fly. Enjoy!
Commands are sent to Things by constructing special URL links of the form:
1
2
3
4
things:///commandName?
parameter1=value1&
parameter2=value2&
...
Opening these links will launch the app and execute the command. Here’s how you would tell Things to create a to-do:
1
2
3
things:///add?
title=Buy%20milk&
notes=High%20fat
Support for x-callback-url
All commands support the x-callback-url convention by calling the provided x-success, x-error or x-cancel callbacks as appropriate. Many commands return parameters to the x-success callback.
Getting IDs
Some commands require you to provide IDs of to-dos or lists. Here’s how you can retrieve them in Things.
To get the ID of a to-do:
- On the Mac, control-click on the to-do and choose Share > Copy Link.
- On iOS, tap the to-do to open it and in the toolbar at the bottom, tap > Share > Copy Link.
To get the ID of a list:
- On the Mac, control-click on the list in the sidebar and choose Share > Copy Link.
- On iOS, navigate into the list and at the top right of the screen, tap > Share > Copy Link.
For security reasons, commands that modify existing Things data require an authorization token to run. This prevents malicious links from modifying your data. This token should be passed as the parameter auth-token along with the other parameters in the command. You can find your unique token in Things’ settings:
- On the Mac, go to Things > Preferences > General > Enable Things URLs > Manage.
- On iOS, go to Settings > General > Things URLs.
Data Types
The commands use the following data types for their parameters:
string
Percent encoded. Maximum un-encoded string length: 4,000 characters unless otherwise specified.
date string
String. Either today, tomorrow or a date string of the form yyyy-mm-dd. E.g. 2017-09-29. Things will also attempt to interpret natural language dates such as in 3 days or next tuesday. These must be provided in English, regardless of the user’s device language.
time string
A string describing a time in the local time zone. E.g. 9:30PM or 21:30.
date time string
A date string followed by the @ symbol and then followed by a time string. E.g. 2018-02-25@14:00.
ISO8601 date time string
A date-time string conforming to ISO8601. E.g. 2018-03-10T14:30:00Z+01:00.
boolean
A boolean value. Either true or false.
JSON string
A string in JSON format. See http://www.json.org/ for more details.
Enabling the URL Scheme
The first time you execute a command via the URL scheme, Things will ask you if you want to enable this feature. Simply answer with Enable.
You can later change this in Things’ settings:
- On the Mac, go to Things > Preferences > General.
- On iOS, go to Settings > General > Things URLs.
Version
The current version of the URL scheme is 2.
Add a to-do. For example, create a to-do in the inbox:
1
2
things:///add?
title=Book%20flights
Create a to-do with a tag and notes set to start this evening:
1
2
3
4
5
things:///add?
title=Buy%20milk&
notes=Low%20fat.&
when=evening&
tags=Errand
Create several to-dos and add them to the Shopping project:
1
2
3
things:///add?
titles=Milk%0aBeer%0aCheese&
list=Shopping
Create and schedule a to-do for next Monday in the Health area (with ID of 3052219D-8039-43D0-8654-AE1E20BE4F56):
1
2
3
4
things:///add?
title=Call%20doctor&
when=next%20monday&
list-id=3052219D-8039-43D0-8654-AE1E20BE4F56
Create a to-do in the “This Evening” list with a reminder at 6PM:
1
2
3
things:///add?
title=Collect%20dry%20cleaning&
when=evening@6pm
Parameters
All parameters are optional. If neither the when nor list-id are specified, the to-do will be added to the inbox.
title
String. The title of the to-do to add. Ignored if titles is also specified.
titles
String separated by new lines (encoded to %0a). Use instead of title to create multiple to-dos. Takes priority over title and show-quick-entry. The other parameters are applied to all the created to-dos.
notes
String. The text to use for the notes field of the to-do. Maximum unencoded length: 10,000 characters.
when
String. Possible values: today, tomorrow, evening, anytime, someday, a date string, or a date time string. Using a date time string adds a reminder for that time. The time component is ignored if anytime or someday is specified.
deadline
Date string. The deadline to apply to the to-do.
tags
Comma separated strings corresponding to the titles of tags. Does not apply a tag if the specified tag doesn’t exist.
checklist-items
String separated by new lines (encoded to %0a). Checklist items to add to the to-do (maximum of 100).
use-clipboard
String. Possible values can be replace-title (newlines overflow into notes, replacing them), replace-notes, or replace-checklist-items (newlines create multiple checklist rows). Takes priority over title, notes, or checklist-items.
list-id
String. The ID of a project or area to add to. Takes precedence over list.
list
String. The title of a project or area to add to. Ignored if list-id is present.
heading
String. The title of a heading within a project to add to. Ignored if a project is not specified, or if the heading doesn’t exist.
completed
Boolean. Whether or not the to-do should be set to complete. Default: false. Ignored if canceled is also set to true.
canceled
Boolean. Whether or not the to-do should be set to canceled. Default: false. Takes priority over completed.
show-quick-entry
Boolean. Whether or not to show the quick entry dialog (populated with the provided data) instead of adding a new to-do. Ignored if titles is specified. Default: false.
reveal
Boolean. Whether or not to navigate to and show the newly created to-do. If multiple to-dos have been created, the first one will be shown. Ignored if show-quick-entry is also set to true. Default: false.
creation-date
ISO8601 date time string. The date to set as the creation date for the to-do in the database. Ignored if the date is in the future.
completion-date
ISO8601 date time string. The date to set as the completion date for the to-do in the database. Ignored if the to-do is not completed or canceled, or if the date is in the future.
Return parameters on x-success
x-things-id
Comma separated string. The IDs of the to-dos created.
Add a project. For example, create a project to build a treehouse set to start today:
1
2
3
things:///add-project?
title=Build%20treehouse&
when=today
Create a project inside the Family area:
1
2
3
things:///add-project?
title=Plan%20Birthday%20Party&
area=Family
Create a project inside the Finance area (with ID of F00A4075-0CA6-4A7F-88C6-CC8B4F1712FC) with a deadline of December 31:
1
2
3
4
things:///add-project?
title=Submit%20Tax&
deadline=December%2031&
area-id=F00A4075-0CA6-4A7F-88C6-CC8B4F1712FC
Parameters
All parameters are optional.
title
String. The title of the project.
notes
String. The text to use for the notes field of the project. Maximum unencoded length: 10,000 characters.
when
String. Possible values: today, tomorrow, evening, anytime, someday, a date string, or a date time string. Using a date time string adds a reminder for that time. The time component is ignored if anytime or someday is specified.
deadline
Date string. The deadline to apply to the project.
tags
Comma separated strings corresponding to the titles of tags. Does not apply a tag if the specified tag doesn’t exist.
area-id
String. The ID of an area to add to. Takes precedence over area.
area
String. The title of an area to add to. Ignored if area-id is present.
to-dos
String separated by new lines (encoded to %0a). Titles of to-dos to create inside the project.
completed
Boolean. Whether or not the project should be set to complete. Default: false. Ignored if canceled is also set to true. Will set all child to-dos to be completed.
canceled
Boolean. Whether or not the project should be set to canceled. Default: false. Takes priority over completed. Will set all child to-dos to be canceled.
reveal
Boolean. Whether or not to navigate into the newly created project. Default: false.
creation-date
ISO8601 date time string. The date to set as the creation date for the project in the database. If the to-dos parameter is also specified, this date is applied to them, too. Ignored if the date is in the future.
completion-date
ISO8601 date time string. The date to set as the completion date for the project in the database. If the to-dos parameter is also specified, this date is applied to them, too. Ignored if the to-do is not completed or canceled, or if the date is in the future.
Return parameters on x-success
x-things-id
string. The ID of the project created.
Update an existing to-do. For example, set a to-do to start today:
1
2
3
things:///update?
id=4BE64FEA-8FEF-4F4F-B8B2-4E74605D5FA5&
when=today
Change the title of a to-do:
1
2
3
things:///update?
id=4BE64FEA-8FEF-4F4F-B8B2-4E74605D5FA5&
title=Buy%20bread
Append notes to a to-do:
1
2
3
things:///update?
id=4BE64FEA-8FEF-4F4F-B8B2-4E74605D5FA5&
append-notes=Wholemeal%20bread
Add some checklist items to a to-do:
1
2
3
things:///update?
id=4BE64FEA-8FEF-4F4F-B8B2-4E74605D5FA5&
append-checklist-items=Cheese%0aBread%0aEggplant
Remove the deadline from a to-do:
1
2
3
things:///update?
id=4BE64FEA-8FEF-4F4F-B8B2-4E74605D5FA5&
deadline=
Parameters
id and auth-token must be specified. All other parameters are optional. Including a parameter with an equals sign (=) but without a value will clear that value (see deadline example).
auth-token
String. The Things URL scheme authorization token.
id
String. The ID of the to-do to update. Required.
title
String. The title of the to-do. This will replace the existing title.
notes
String. The notes of the to-do. This will replace the existing notes. Maximum unencoded length: 10,000 characters.
prepend-notes
String. Text to add before the existing notes of a to-do. Maximum unencoded length: 10,000 characters.
append-notes
String. Text to add after the existing notes of a to-do. Maximum unencoded length: 10,000 characters.
when
String. Set the when field of a to-do. Possible values: today, tomorrow, evening, someday, a date string, or a date time string. Including a time adds a reminder for that time. The time component is ignored if someday is specified. This field cannot be updated on repeating to-dos.
deadline
Date string. The deadline to apply to the to-do. This field cannot be updated on repeating to-dos.
tags
Comma separated strings corresponding to the titles of tags. Replaces all current tags. Does not apply a tag if the specified tag doesn’t exist.
add-tags
Comma separated strings corresponding to the titles of tags. Adds the specified tags to a to-do. Does not apply a tag if the specified tag doesn’t exist.
checklist-items
\n (encoded to %0a) separated strings. Set the checklist items of the to-do (maximum of 100). Will replace all existing checklist items.
prepend-checklist-items
\n (encoded to %0a) separated strings. Add checklist items to the front of the list of checklist items in the to-do (maximum of 100).
append-checklist-items
\n (encoded to %0a) separated strings. Add checklist items to the end of the list of checklist items in the to-do (maximum of 100).
list-id
String. The ID of a project or area to move the to-do into. Takes precedence over list.
list
String. The title of a project or area to move the to-do into. Ignored if list-id is present.
heading
String. The title of a heading within a project to move the to-do to. Ignored if the to-do is not in a project with the specified heading. Can be used together with list or list-id.
completed
Boolean. Complete a to-do or set a to-do to incomplete. Ignored if canceled is also set to true. Setting completed=false on a canceled to-do will also mark it as incomplete. This field cannot be updated on repeating to-dos.
canceled
Boolean. Cancel a to-do or set a to-do to incomplete. Takes priority over completed. Setting canceled=false on a completed to-do will also mark it as incomplete. This field cannot be updated on repeating to-dos.
reveal
Boolean. Whether or not to navigate to and show the updated to-do. Default: false.
duplicate
Boolean. Set to true to duplicate the to-do before updating it, leaving the original to-do untouched. Repeating to-dos cannot be duplicated. Default: false.
creation-date
ISO8601 date time string. Set the creation date for the to-do in the database. Ignored if the date is in the future.
completion-date
ISO8601 date time string. Set the completion date for the to-do in the database. Ignored if the to-do is not completed or canceled, or if the date is in the future. This field cannot be updated on repeating to-dos.
Return parameters on x-success
x-things-id
String. The ID of the to-do updated.
Update an existing project. For example, set a project to start tomorrow:
1
2
3
things:///update-project?
id=852763FD-5954-4DF9-A88A-2ADD808BD279&
when=tomorrow
Add a tag to a project:
1
2
3
things:///update-project?
id=852763FD-5954-4DF9-A88A-2ADD808BD279&
add-tags=Important
Prepend notes to a project:
1
2
3
things:///update-project?
id=852763FD-5954-4DF9-A88A-2ADD808BD279&
prepend-notes=SFO%20to%20JFK.
Clear the deadline of a project:
1
2
3
things:///update-project?
id=852763FD-5954-4DF9-A88A-2ADD808BD279&
deadline=
Parameters
id and auth-token must be specified. All other parameters are optional. Including a parameter with an equals sign (=) but without a value will clear that value (see deadline example).
auth-token
String. The Things URL scheme authorization token.
id
String. The ID of the project to update. Required.
title
String. The title of the project. This will replace the existing title.
notes
String. The notes of the project. This will replace the existing notes. Maximum unencoded length: 10,000 characters.
prepend-notes
String. Text to add before the existing notes of a project. Maximum unencoded length: 10,000 characters.
append-notes
String. Text to add after the existing notes of a project. Maximum unencoded length: 10,000 characters.
when
String. Set the when field of a project. Possible values: today, tomorrow, evening, someday, a date string, or a date time string. Including a time adds a reminder for that time. The time component is ignored if someday is specified. This field cannot be updated on repeating projects.
deadline
Date string. The deadline to apply to the project. This field cannot be updated on repeating projects.
tags
Comma separated strings corresponding to the titles of tags. Replaces all current tags. Does not apply a tag if the specified tag doesn’t exist.
add-tags
Comma separated strings corresponding to the titles of tags. Adds the specified tags to a project. Does not apply a tag if the specified tag doesn’t exist.
area-id
String. The ID of an area to move the project into. Takes precedence over area.
area
String. The title of an area to move the project into. Ignored if area-id is present.
completed
Boolean. Complete a project or set a project to incomplete. Ignored if canceled is also set to true. Setting to true will be ignored unless all child to-dos are completed or canceled and all child headings archived. Setting to false on a canceled project will mark it as incomplete. This field cannot be updated on repeating projects.
canceled
Boolean. Cancel a project or set a project to incomplete. Takes priority over completed. Setting to true will be ignored unless all child to-dos are completed or canceled and all child headings archived. Setting to false on a completed project will mark it as incomplete. This field cannot be updated on repeating projects.
reveal
Boolean. Whether or not to navigate to and show the updated project. Default: false.
duplicate
Boolean. Set to true to duplicate the project before updating it, leaving the original project untouched. Repeating projects cannot be duplicated. Default: false.
creation-date
ISO8601 date time string. Set the creation date for the project in the database. Ignored if the date is in the future.
completion-date
ISO8601 date time string. Set the completion date for the project in the database. Ignored if the project is not completed or canceled, or if the date is in the future. This field cannot be updated on repeating projects.
Return parameters on x-success
x-things-id
String. The ID of the project updated.
Navigate to and show an area, project, tag or to-do, or one of the built-in lists, optionally filtering by one or more tags.
Navigate to the Today list:
1
2
things:///show?
id=today
Show to-do with ID 8796CC16E-92FA-4809-9A26-36194985E87B:
1
2
things:///show?
id=8796CC16E-92FA-4809-9A26-36194985E87B
Navigate into project with ID 9096CC16E-92FA-4809-9A26-36194985E44A:
1
2
things:///show?
id=9096CC16E-92FA-4809-9A26-36194985E44A
Show project with title “Vacation”:
1
2
things:///show?
query=vacation
Show project with title “Vacation”, filtering by the “Errand” tag:
1
2
3
things:///show?
query=vacation&
filter=errand
Parameters
Either id or query must be specified; filter is optional.
id
String. The ID of an area, project, tag or to-do to show; or one of the following built-in list IDs: inbox, today, anytime, upcoming, someday, logbook, tomorrow, deadlines, repeating, all-projects, logged-projects. Takes precedence over query.
query
String. The name of an area, project, tag or a built-in list to show. This is equivalent to entering the query text in to the quick find within Things and selecting the first result. Ignored if id is also set. Note: task cannot be shown using the query parameter; use the id parameter or the search command instead.
filter
String. Comma separated strings corresponding to the titles of tags that the list should be filtered by.
Return parameters on x-success
none
Invoke and show the search screen. For example, search for the text “vacation”:
1
2
things:///search?
query=vacation
Show the search screen without searching for anything:
1
things:///search
Parameters
All parameters are optional.
query
String. The search query.
Return parameters on x-success
none
The version of the Things app and URL scheme.
1
things:///version
Parameters
none
Return parameters on x-success
x-things-scheme-version
String. The version of the Things URL scheme.
x-things-client-version
String. The build number of the app.
Things also has an advanced, JSON-based add command that allows more control over the projects and to-dos imported into Things. This command is intended to be used by app developers or other people familiar with scripting or programming.
We’ve created a set of Swift helper classes that you can use to more easily generate the JSON needed for this command. Get the code from the Things JSON Coder GitHub repository.
Example:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
things:///json?data=
\[
{
"type": "project",
"attributes": {
"title": "Go Shopping",
"items": \[
{
"type": "to-do",
"attributes": {
"title": "Bread"
}
},
{
"type": "to-do",
"attributes": {
"title": "Milk"
}
}
\]
}
}
\]
Parameters
auth-token
String. The Things URL scheme authorization token. This is required whenever the provided JSON data contains an update operation.
data
JSON string. The JSON should be an array containing to-do and project objects (see below).
reveal
Boolean. Whether or not to navigate to and show the newly created to-do or project. If multiple items have been created, the first one will be shown. Default: false.
Return parameters on x-success
x-things-ids
JSON string. An array of IDs of the to-dos and projects created that were specified in the top level JSON array. The IDs of the to-dos created inside projects are not returned.
Describing Things objects in JSON
Each operation consists of the following fields:
typeThe type of the object. These are described in more detail below. This field is required.operationThe operation to perform on the object. Eithercreate(create a new object) orupdate(update the fields of an existing object). If this field is not present, the operation is assumed to becreate. Currently onlyto-doandprojectobjects can be updated.idRequired for update operations, this is the ID of the object to update.attributesA dictionary of attributes, which correspond to the properties of the object itself. Theattributesfield must be included but all attributes themselves are optional.
1
2
3
4
5
6
7
8
{
"type": "to-do",
"operation": "update",
"id": "1BD13549-0BE7-49AC-B645-74B7BA8DE7C4",
"attributes": {
"deadline": "today"
}
}
To-do
1
2
3
4
5
6
{
"type": "to-do",
"attributes": {
"title": "Milk"
}
}
typeisto-do.attributes:title- string. The title of the to-do.notes- string. The text to use for the notes field of the to-do. Maximum length: 10,000 characters.when- string. Possible values:today,tomorrow,evening,anytime,someday, a date string, or a date time string. Using a date time string adds a reminder for that time. The time component is ignored ifanytimeorsomedayis specified.deadline- date string. The deadline to apply to the to-do.tags- array of strings corresponding to the titles of tags. Does not apply a tag if a tag with the specified title doesn’t exist.checklist-items- array ofchecklist-itemobjects (maximum of 100).list-id- string. The ID of a project or area to add to. Takes precedence overlist. Ignored if the to-do is specified inside theitemsarray of aprojectobject.list- string. The title of a project or area to add to. Ignored iflist-idis present, or if the to-do is specified inside theitemsarray of aprojectobject.heading- string. The title of a heading within a project to add to. Ignored if a project is not specified, if the heading doesn’t exist, or if the to-do is specified inside theitemsarray of aprojectobject.completed- boolean. Whether or not the to-do should be set to complete. Default:false. Ignored ifcanceledis also set totrue.canceled- boolean. Whether or not the to-do should be set to canceled. Default:false. Takes priority overcompleted.creation-date- ISO8601 date time string. The date to set as the creation date for the to-do in the database. Ignored if the date is in the future.completion-date- ISO8601 date time string. The date to set as the completion date for the to-do in the database. Ignored if the to-do is not completed or canceled, or if the date is in the future.
updatespecificattributes. These attributes can only be used withupdateoperations:prepend-notes- string. Text to add before the existing notes of a to-do. Maximum unencoded length: 10,000 characters.append-notes- string. Text to add after the existing notes of a to-do. Maximum unencoded length: 10,000 characters.add-tags- comma separated strings corresponding to the titles of tags. Adds the specified tags to a to-do. Does not apply a tag if the specified tag doesn’t exist.prepend-checklist-items-\n(encoded to%0a) separated strings. Add checklist items to the front of the list of checklist items in the to-do (maximum of 100).append-checklist-items-\n(encoded to%0a) separated strings. Add checklist items to the end of the list of checklist items in the to-do (maximum of 100).
Project
1
2
3
4
5
6
7
8
9
10
11
12
13
14
{
"type": "project",
"attributes": {
"title": "Go Shopping",
"items": \[
{
"type": "to-do",
"attributes": {
"title": "Bread"
}
}
\]
}
}
typeisproject.attributes:title- string. The title of the project.notes- string. The text to use for the notes field (maximum length: 10,000 characters).when- string. Possible values:today,tomorrow,evening,anytime,someday, a date string, or a date time string. Using a date time string adds a reminder for that time. The time component is ignored ifanytimeorsomedayis specified.deadline- date string. The deadline to apply.tags- array of strings corresponding to the titles of tags. Does not apply a tag if a tag with the specified title doesn’t exist.area-id- string. The ID of an area to add to. Takes precedence overarea.area- string. The title of an area to add to. Ignored ifarea-idis present.completed- boolean. Whether or not the project should be set to complete. Default:false. Ignored unless all child to-dos are completed or canceled.canceled- boolean. Whether or not the project should be set to canceled. Default:false. Takes priority overcompleted. Ignored unless all child to-dos are completed or canceled.creation-date- ISO8601 date time string. The date to set as the creation date for the project in the database. Ignored if the date is in the future.completion-date- ISO8601 date time string. The date to set as the completion date for the project in the database. Ignored if the project is not completed or canceled, or if the date is in the future.
createspecificattributes. These attributes can only be used withcreateoperations:items- array ofto-doorheadingobjects. To add to-dos to an existing project, create individualto-doobjects instead.
updatespecificattributes. These attributes can only be used withupdateoperations:prepend-notesString. Text to add before the existing notes of a project. Maximum unencoded length: 10,000 characters.append-notesString. Text to add after the existing notes of a project. Maximum unencoded length: 10,000 characters.add-tagsComma separated strings corresponding to the titles of tags. Adds the specified tags to a project. Does not apply a tag if the specified tag doesn’t exist.
Heading
1
2
3
4
5
6
{
"type": "heading",
"attributes": {
"title": "Sights"
}
}
typeisheading.attributes:title- string. The title of the heading.archived- boolean. Whether or not the heading is archived. Default:false. Ignored unless all to-dos under the heading are completed or canceled.
Checklist Item
1
2
3
4
5
6
7
{
"type": "checklist-item",
"attributes": {
"title": "Hotels",
"completed": true
}
}
typeischecklist-item.attributes:title- string. The title of the checklist item.completed- boolean. Whether or not the checklist item should be set to complete. Default:false. Ignored ifcanceledis also set totrue.canceled- boolean. Whether or not the checklist item should be set to canceled. Default:false. Takes priority overcompleted.
JSON Example
This example is not URL encoded for clarity.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
things:///json?data=
\[
{
"type": "project",
"attributes": {
"title": "Go Shopping",
"items": \[
{
"type": "to-do",
"attributes": {
"title": "Bread"
}
},
{
"type": "to-do",
"attributes": {
"title": "Milk"
}
}
\]
}
},
{
"type": "project",
"attributes": {
"title": "Vacation in Rome",
"notes": "Some time in August.",
"area": "Family",
"items": \[
{
"type": "to-do",
"attributes": {
"title": "Ask Sarah for travel guide"
}
},
{
"type": "to-do",
"attributes": {
"title": "Add dates to calendar"
}
},
{
"type": "heading",
"attributes": {
"title": "Sights"
}
},
{
"type": "to-do",
"attributes": {
"title": "Vatican City"
}
},
{
"type": "to-do",
"attributes": {
"title": "The Colosseum",
"notes": "12€"
}
},
{
"type": "heading",
"attributes": {
"title": "Planning"
}
},
{
"type": "to-do",
"attributes": {
"title": "Call Paolo",
"completed": true
}
},
{
"type": "to-do",
"attributes": {
"title": "Book flights",
"when": "today"
}
},
{
"type": "to-do",
"attributes": {
"title": "Research",
"checklist-items": \[
{
"type": "checklist-item",
"attributes": {
"title": "Hotels",
"completed": true
}
},
{
"type": "checklist-item",
"attributes": {
"title": "Transport from airport"
}
}
\]
}
}
\]
}
},
{
"type": "to-do",
"attributes": {
"title": "Pick up dry cleaning",
"when": "evening",
"tags": \[
"Errand"
\]
}
},
{
"type": "to-do",
"attributes": {
"title": "Submit report",
"deadline": "2018-02-01",
"list": "Work"
}
}
\]
URL Encoded Example
All of the above JSON examples must have the white space removed and then be URL encoded before they can be used. For example:
1
2
3
4
5
6
7
8
9
things:///json?data=
\[
{
"type": "to-do",
"attributes": {
"title": "Buy milk"
}
}
\]
After removing white space:
1
things:///json?data=\[{"type":"to-do","attributes":{"title":"Buy milk"}}\]
After URL encoding:
1
things:///json?data=%5B%7B%22type%22:%22to-do%22,%22attributes%22:%7B%22title%22:%22Buy%20milk%22%7D%7D%5D
Deprecated. The json command can be used for adding items via JSON.
