基础URL

https://gateway.maton.ai/microsoft-excel/{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 Excel OAuth连接。

列出连接

bash
python < import urllib.request, os, json
req = urllib.request.Request(https://ctrl.maton.ai/connections?app=microsoft-excel&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-excel}).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: 4751ac89-3970-47e1-872c-eacdf4291732,
status: ACTIVE,
creation_time: 2026-02-07T00:43:18.565932Z,
lastupdatedtime: 2026-02-07T00:43:29.729782Z,
url: https://connect.maton.ai/?session_token=...,
app: microsoft-excel,
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 Excel连接，请使用Maton-Connection头指定要使用的连接：

bash
python < import urllib.request, os, json
req = urllib.request.Request(https://gateway.maton.ai/microsoft-excel/v1.0/me/drive)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
req.add_header(Maton-Connection, 4751ac89-3970-47e1-872c-eacdf4291732)
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

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

工作簿访问模式

您可以使用基于ID或基于路径的模式访问工作簿：

按文件ID：

/microsoft-excel/v1.0/me/drive/items/{file-id}/workbook/...

按文件路径：

/microsoft-excel/v1.0/me/drive/root:/{path-to-file}:/workbook/...

API参考

驱动器操作

获取驱动器信息

bash
GET /microsoft-excel/v1.0/me/drive

列出根目录文件

bash
GET /microsoft-excel/v1.0/me/drive/root/children

搜索Excel文件

bash
GET /microsoft-excel/v1.0/me/drive/root/search(q=.xlsx)

上传Excel文件

bash
PUT /microsoft-excel/v1.0/me/drive/root:/{filename}.xlsx:/content
Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

{binary xlsx content}

会话管理

会话可提高多个操作的性能。建议用于批量操作。

创建会话

bash
POST /microsoft-excel/v1.0/me/drive/root:/{path}:/workbook/createSession
Content-Type: application/json

{
persistChanges: true
}

响应：
json
{
persistChanges: true,
id: cluster=PUS7&session=...
}

在后续请求中使用会话ID：

workbook-session-id: {session-id}

关闭会话

bash
POST /microsoft-excel/v1.0/me/drive/root:/{path}:/workbook/closeSession
workbook-session-id: {session-id}

工作表操作

列出工作表

bash
GET /microsoft-excel/v1.0/me/drive/root:/workbook.xlsx:/workbook/worksheets

响应：
json
{
value: [
{
id: {00000000-0001-0000-0000-000000000000},
name: Sheet1,
position: 0,
visibility: Visible
}
]
}

获取工作表

bash
GET /microsoft-excel/v1.0/me/drive/root:/workbook.xlsx:/workbook/worksheets(Sheet1)

创建工作表

bash
POST /microsoft-excel/v1.0/me/drive/root:/workbook.xlsx:/workbook/worksheets
Content-Type: application/json

{
name: NewSheet
}

更新工作表

bash
PATCH /microsoft-excel/v1.0/me/drive/root:/workbook.xlsx:/workbook/worksheets(Sheet1)
Content-Type: application/json

{
name: RenamedSheet,
position: 2
}

删除工作表

bash
DELETE /microsoft-excel/v1.0/me/drive/root:/workbook.xlsx:/workbook/worksheets({worksheet-id})

成功时返回204 No Content。

区域操作

获取区域

bash
GET /microsoft-excel/v1.0/me/drive/root:/workbook.xlsx:/workbook/worksheets(Sheet1)/range(address=A1:B2)

响应：
json
{
address: Sheet1!A1:B2,
values: [
[Hello, World],
[1, 2]
],
formulas: [
[Hello, World],
[1, 2]
],
text: [
[Hello, World],
[1, 2]
],
numberFormat: [
[General, General],
[General, General]
],
rowCount: 2,
columnCount: 2
}

获取已用区域

bash
GET /microsoft-excel/v1.0/me/drive/root:/workbook.xlsx:/workbook/worksheets(Sheet1)/usedRange

更新区域

bash
PATCH /microsoft-excel/v1.0/me/drive/root:/workbook.xlsx:/workbook/worksheets(Sheet1)/range(address=