|
通过托管的OAuth认证访问Podio API。管理组织、工作区（空间）、应用、项目、任务、评论和文件。
bash
https://gateway.maton.ai/podio/{原生API路径}
将{原生API路径}替换为实际的Podio API端点路径。网关将请求代理到api.podio.com并自动注入您的OAuth令牌。
所有请求都需要在Authorization标头中包含Maton API密钥：
Authorization: Bearer $MATONAPIKEY
环境变量： 将您的API密钥设置为MATONAPIKEY：
bash
export MATONAPIKEY=您的API密钥
在https://ctrl.maton.ai管理您的Podio OAuth连接。
bash
python <
req = urllib.request.Request(https://ctrl.maton.ai/connections?app=podio&status=ACTIVE)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
bash
python <
data = json.dumps({app: podio}).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 <
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: podio,
metadata: {}
}
}
在浏览器中打开返回的url以完成OAuth授权。
bash
python <
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
如果您有多个Podio连接，请使用Maton-Connection标头指定要使用的连接：
bash
python <
req = urllib.request.Request(https://gateway.maton.ai/podio/org/)
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
如果省略，网关将使用默认（最早）的活动连接。
返回用户所属的所有组织和空间。
bash
GET /podio/org/
响应：
json
[
{
org_id: 123456,
name: 我的组织,
url: https://podio.com/myorg,
url_label: myorg,
type: premium,
role: admin,
status: active,
spaces: [
{
space_id: 789,
name: 项目空间,
url: https://podio.com/myorg/project-space,
role: admin
}
]
}
]
bash
GET /podio/org/{org_id}
bash
GET /podio/space/{space_id}
响应：
json
{
space_id: 789,
name: 项目空间,
privacy: closed,
auto_join: false,
url: https://podio.com/myorg/project-space,
url_label: project-space,
role: admin,
created_on: 2025-01-15T10:30:00Z,
created_by: {
user_id: 12345,
name: 张三
}
}
bash
POST /podio/space/
Content-Type: application/json
{
org_id: 123456,
name: 新项目空间,
privacy: closed,
auto_join: false,
postonnew_app: true,
postonnew_member: true
}
响应：
json
{
space_id: 790,
url: https://podio.com/myorg/new-project-space
}
bash
GET /podio/app/space/{space_id}/
可选查询参数：
bash
GET /podio/app/{app_id}
响应：
json
{
app_id: 456,
status: active,
space_id: 789,
config: {
name: 任务,
item_name: 任务项,
description: 跟踪项目任务,
icon: list
},
fields: [...]
}
bash
GET /podio/item/{item_id}
可选查询参数：
响应：
json
{
item_id: 123,
title: 完成项目计划,
app: {
app_id: 456,
name: 任务
},
fields: [
{
field_id: 1,
external_id: status,
type: category,
values: [{value: {text: 进行中}}]
}
],
created_on: 2025-01-20T14:00:00Z,
created_by: {
user_id: 12345,
name: 张三
}
}
bash
POST /podio/item/app/{app_id}/filter/
Content-Type: application/json
{
sortby: createdon,
sort_desc: true,
filters: {
status: [1, 2]
},
limit: 30,
offset: 0
}
响应：
json
{
total: 150,
filtered: 45,
items: [
{
item_id: 123,
title: 完成项目计划,
fields: [...],
comment_count: 5,
file_count: 2
}
]
}
bash
POST /podio/item/app/{app_id}/
Content-Type: application/json
{
fields: {
title: 新任务,
status: 1,
due-date: {start: 2025-02-15}
},
tags: [紧急, 项目Alpha],
file_ids: [12345]
}
可选查询参数：
该技能支持在以下平台通过对话安装：
帮我安装 SkillHub 和 podio-1776193815 技能
设置 SkillHub 为我的优先技能安装源，然后帮我安装 podio-1776193815 技能
skillhub install podio-1776193815
文件大小: 5.34 KB | 发布时间: 2026-4-15 11:53
