基础URL

https://gateway.maton.ai/microsoft-to-do/{native-api-path}

将{native-api-path}替换为实际的Microsoft Graph API端点路径。网关会将请求代理到graph.microsoft.com，并自动注入您的OAuth令牌。

认证

所有请求都需要在Authorization头中携带Maton API密钥：

Authorization: Bearer $MATONAPIKEY

环境变量： 将您的API密钥设置为MATONAPIKEY：

bash
export MATONAPIKEY=YOURAPIKEY

获取您的API密钥

1. 1. 在maton.ai登录或创建账户
2. 前往maton.ai/settings
3. 复制您的API密钥

连接管理

在https://ctrl.maton.ai管理您的Microsoft To Do OAuth连接。

列出连接

bash
python < import urllib.request, os, json
req = urllib.request.Request(https://ctrl.maton.ai/connections?app=microsoft-to-do&status=ACTIVE)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

创建连接

bash
python < import urllib.request, os, json
data = json.dumps({app: microsoft-to-do}).encode()
req = urllib.request.Request(https://ctrl.maton.ai/connections, data=data, method=POST)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
req.add_header(Content-Type, application/json)
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

获取连接

bash
python < import urllib.request, os, json
req = urllib.request.Request(https://ctrl.maton.ai/connections/{connection_id})
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

响应：
json
{
connection: {
connection_id: 21fd90f9-5935-43cd-b6c8-bde9d915ca80,
status: ACTIVE,
creation_time: 2025-12-08T07:20:53.488460Z,
lastupdatedtime: 2026-01-31T20:03:32.593153Z,
url: https://connect.maton.ai/?session_token=...,
app: microsoft-to-do,
metadata: {}
}
}

在浏览器中打开返回的url以完成OAuth授权。

删除连接

bash
python < import urllib.request, os, json
req = urllib.request.Request(https://ctrl.maton.ai/connections/{connection_id}, method=DELETE)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

指定连接

如果您有多个Microsoft To Do连接，可以使用Maton-Connection头指定使用哪个连接：

bash
python < import urllib.request, os, json
req = urllib.request.Request(https://gateway.maton.ai/microsoft-to-do/v1.0/me/todo/lists)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
req.add_header(Maton-Connection, 21fd90f9-5935-43cd-b6c8-bde9d915ca80)
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

如果省略，网关将使用默认（最早创建的）活动连接。

API参考

任务列表操作

列出任务列表

bash
GET /microsoft-to-do/v1.0/me/todo/lists

响应：
json
{
value: [
{
id: AAMkADIyAAAhrbPWAAA=,
displayName: Tasks,
isOwner: true,
isShared: false,
wellknownListName: defaultList
}
]
}

获取任务列表

bash
GET /microsoft-to-do/v1.0/me/todo/lists/{todoTaskListId}

创建任务列表

bash
POST /microsoft-to-do/v1.0/me/todo/lists
Content-Type: application/json

{
displayName: Travel items
}

响应（201 Created）：
json
{
id: AAMkADIyAAAhrbPWAAA=,
displayName: Travel items,
isOwner: true,
isShared: false,
wellknownListName: none
}

更新任务列表

bash
PATCH /microsoft-to-do/v1.0/me/todo/lists/{todoTaskListId}
Content-Type: application/json

{
displayName: Vacation Plan
}

删除任务列表

bash
DELETE /microsoft-to-do/v1.0/me/todo/lists/{todoTaskListId}

成功时返回204 No Content。

任务操作

列出任务

bash
GET /microsoft-to-do/v1.0/me/todo/lists/{todoTaskListId}/tasks

响应：
json
{
value: [
{
id: AlMKXwbQAAAJws6wcAAAA=,
title: Buy groceries,
status: notStarted,
importance: normal,
isReminderOn: false,
createdDateTime: 2024-01-15T10:00:00Z,
lastModifiedDateTime: 2024-01-15T10:00:00Z,
body: {
content: ,
contentType: text
},
categories: []
}
]
}

获取任务

bash
GET /microsoft-to-do/v1.0/me/todo/lists/{todoTaskListId}/tasks/{taskId}

创建任务

bash
POST /microsoft-to-do/v1.0/me/todo/lists/{todoTaskListId}/tasks
Content-Type: application/json

{
title: A new task,
importance: high,
status: notStarted,
categories: [Important],
dueDateTime: {
dateTime: 2024-12-31T17:00:00,
timeZone: Eastern Standard Time
},
startDateTime: {
dateTime: 2024-12-01T08:00:00,
timeZone: Eastern Standard Time
},
isReminderOn: true,
reminderDateTime: {
dateTime: 2024-12-01T09:00:00,
timeZone: Eastern Standard Time
},
body: {
content: Task details here,
contentType: text
}
}

任务字段：

更新任务