基础URL

https://gateway.maton.ai/zoho-projects/{native-api-path}

将{native-api-path}替换为实际的Zoho Projects API端点路径。网关将请求代理到projectsapi.zoho.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 管理您的Zoho Projects OAuth连接。

列出连接

bash
python < import urllib.request, os, json
req = urllib.request.Request(https://ctrl.maton.ai/connections?app=zoho-projects&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: zoho-projects}).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: 522c11a9-b879-4504-b267-355e3dbac99f,
status: ACTIVE,
creation_time: 2026-02-28T00:12:25.223434Z,
lastupdatedtime: 2026-02-28T00:16:32.882675Z,
url: https://connect.maton.ai/?session_token=...,
app: zoho-projects,
metadata: {},
method: OAUTH2
}
}

在浏览器中打开返回的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

指定连接

如果您有多个Zoho Projects连接，请使用Maton-Connection头指定要使用的连接：

bash
python < import urllib.request, os, json
req = urllib.request.Request(https://gateway.maton.ai/zoho-projects/restapi/portals/)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
req.add_header(Maton-Connection, 522c11a9-b879-4504-b267-355e3dbac99f)
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

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

API参考

门户

列出门户

bash
GET /zoho-projects/restapi/portals/

响应：
json
{
portals: [
{
id: 916020774,
id_string: 916020774,
name: nunchidotapp,
plan: Ultimate,
role: admin,
project_count: {active: 1}
}
]
}

获取门户详情

bash
GET /zoho-projects/restapi/portal/{portal_id}/

项目

列出项目

bash
GET /zoho-projects/restapi/portal/{portal_id}/projects/

查询参数：index, range, status, sortcolumn, sortorder

响应：
json
{
projects: [
{
id: 2644874000000089119,
name: My Project,
status: active,
owner_name: Byungkyu Park,
task_count: {open: 3, closed: 0},
project_percent: 0
}
]
}

获取项目详情

bash
GET /zoho-projects/restapi/portal/{portalid}/projects/{projectid}/

创建项目

bash
POST /zoho-projects/restapi/portal/{portal_id}/projects/
Content-Type: application/x-www-form-urlencoded

name=New+Project&owner={user_id}&description=Project+description

必填：name
可选：owner, description, startdate, enddate, templateid, groupid

响应：
json
{
projects: [
{
id: 2644874000000096003,
name: New Project,
status: active
}
]
}

更新项目

bash
POST /zoho-projects/restapi/portal/{portalid}/projects/{projectid}/
Content-Type: application/x-www-form-urlencoded

name=Updated+Name&status=active

删除项目

bash
DELETE /zoho-projects/restapi/portal/{portalid}/projects/{projectid}/

响应：
json
{response: Project Trashed successfully}

任务

列出任务

bash
GET /zoho-projects/restapi/portal/{portalid}/projects/{projectid}/tasks/

查询参数：index, range, owner, status, priority, tasklistid, sortcolumn

响应：
json
{
tasks: [
{
id: 2644874000000089255,
name: Task 3,
status: {name: Open, type: open},
priority: None,
completed: false,
tasklist: {name: General, id: 2644874000000089245}
}
]
}

获取任务详情

bash
GET /zoho-projects/restapi/portal/{portalid}/projects/{projectid}/tasks/{task_id}/

获取我的任务

bash
GET /zoho-projects/restapi/portal/{portal_id}/mytasks/

查询参数：index, range, owner, status, priority, projects_ids

创建任务

bash
POST /zoho-projects/restapi/portal/{portalid}/projects/{projectid}/tasks/
Content-Type: application/x-www-form-urlencoded

name=New+Task&tasklistid={tasklistid}&priority=High

必填：name
可选：personresponsible, tasklistid, startdate, enddate, priority, description

响应：
json
{
tasks: [
{
id: 2644874000000094001,
key: EZ1-T4,
name: New Task,
status: {name: Open, type: open}
}
]
}

更新任务

bash
POST /zoho-projects/restapi/portal/{portalid}/projects/{projectid}/tasks/{task_id}/
Content-Type: application/x-www-form-urlencoded

name=Updated+Name&priority=