Todoist.Net 8.0.0

Todoist.Net

用于 .NET 的 Todoist 同步 API 客户端。

安装

此库作为 Nuget 包 提供。

Install-Package Todoist.Net

开始使用

创建 Todoist 客户端

ITodoistClient client = new TodoistClient("API token");

快速添加

实现了官方客户端中可用的快速添加任务。

var quickAddItem = new QuickAddItem("Task title @Label1 #Project1 +ExampleUser");
var task = await client.Items.QuickAddAsync(quickAddItem);

简单的 API 调用

// Get all resources (labels, projects, tasks, notes etc.).
var resources = await client.GetResourcesAsync();

// Get only projects and labels.
var projectsAndLabels = await client.GetResourcesAsync(ResourceType.Projects, ResourceType.Labels);

// Get only projects.
var projectsOnly = await client.GetResourcesAsync(ResourceType.Projects);

// Alternatively you can use this API to get projects.
var projects = await client.Projects.GetAsync();

// Add a task with a note.
var taskId = await client.Items.AddAsync(new Item("New task"));
await client.Notes.AddToItemAsync(new Note("Task description"), taskId);

事务（批量处理）

批处理：在单个 HTTP 请求中可完成多个资源的读取和写入。

在单个请求中添加新的项目、任务和备注。

// Create a new transaction.
var transaction = client.CreateTransaction();

// These requests are queued and will be executed later.
var projectId = await transaction.Project.AddAsync(new Project("New project"));
var taskId = await transaction.Items.AddAsync(new Item("New task", projectId));
await transaction.Notes.AddToItemAsync(new Note("Task description"), taskId);

// Execute all the requests in the transaction in a single HTTP request.
await transaction.CommitAsync();

在更新实体时发送 null 值。

在更新实体时，Todoist API 仅更新请求体中包含的属性，使用 PATCH 请求样式。这就是为什么默认情况下不包括所有带有 null 值的属性，以允许在不首先获取实体的情况下更新，因为包括 null 属性将把它们更新为 null。

然而，如果您想故意向API发送一个 null 值，您需要使用 Unset 扩展方法，例如

// This code removes a task's due date.
var task = new UpdateItem("TASK_ID");
task.Unset(t => t.DueDate);

await client.Items.UpdateAsync(task);