|
通过托管 OAuth 认证访问 Dropbox Business API。管理团队管理功能，包括成员、群组、团队文件夹、设备、关联应用和审计日志。
bash
https://gateway.maton.ai/dropbox-business/2/{endpoint-path}
将 {endpoint-path} 替换为实际的 Dropbox Business API 端点路径。网关会将请求代理到 api.dropboxapi.com，并自动注入您的 OAuth 令牌。
重要提示： Dropbox Business API 几乎对所有端点（包括读取操作）都使用 POST 方法。请求体应为 JSON 格式（对于无参数的端点，请使用 null）。
所有请求都需要在 Authorization 头中提供 Maton API 密钥：
Authorization: Bearer $MATONAPIKEY
环境变量： 将您的 API 密钥设置为 MATONAPIKEY：
bash
export MATONAPIKEY=YOURAPIKEY
在 https://ctrl.maton.ai 管理您的 Dropbox Business OAuth 连接。
bash
python3 <
req = urllib.request.Request(https://ctrl.maton.ai/connections?app=dropbox-business&status=ACTIVE)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF
bash
python3 <
data = json.dumps({app: dropbox-business}).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
响应：
json
{
connection_id: 09062f57-98a9-49f2-9e63-b2a7e03a9d7a,
status: PENDING,
url: https://connect.maton.ai/?session_token=...,
app: dropbox-business
}
在浏览器中打开返回的 url 以完成 OAuth 授权。
bash
python3 <
req = urllib.request.Request(https://ctrl.maton.ai/connections/{connection_id}, method=DELETE)
req.addheader(Authorization, fBearer {os.environ[MATONAPI_KEY]})
urllib.request.urlopen(req)
print(已删除)
EOF
如果您有多个 Dropbox Business 连接，请使用 Maton-Connection 头指定要使用的连接：
python
req.addheader(Maton-Connection, {connectionid})
如果省略，网关将使用默认（最早）的活动连接。
检索团队信息，包括许可证使用情况和策略。
bash
POST /dropbox-business/2/team/get_info
Content-Type: application/json
null
响应：
json
{
name: 我的公司,
team_id: dbtid:AAC...,
numlicensedusers: 10,
numprovisionedusers: 5,
numusedlicenses: 5,
policies: {
sharing: {...},
emm_state: {.tag: disabled},
office_addin: {.tag: enabled}
}
}
查询团队功能可用性。
bash
POST /dropbox-business/2/team/features/get_values
Content-Type: application/json
{
features: [
{.tag: uploadapirate_limit},
{.tag: hasteamshared_dropbox},
{.tag: hasteamfile_events},
{.tag: hasteamselective_sync}
]
}
响应：
json
{
values: [
{.tag: uploadapiratelimit, uploadapiratelimit: {.tag: limit, limit: 1000000000}},
{.tag: hasteamshareddropbox, hasteamshareddropbox: {.tag: hasteamshareddropbox, hasteamshareddropbox: false}},
{.tag: hasteamfileevents, hasteamfileevents: {.tag: enabled, enabled: true}},
{.tag: hasteamselectivesync, hasteamselectivesync: {.tag: hasteamselectivesync, hasteamselectivesync: true}}
]
}
获取当前已认证管理员的信息。
bash
POST /dropbox-business/2/team/token/getauthenticatedadmin
Content-Type: application/json
null
响应：
json
{
admin_profile: {
teammemberid: dbmid:AAA...,
account_id: dbid:AAC...,
email: admin@company.com,
email_verified: true,
status: {.tag: active},
name: {givenname: 管理员, surname: 用户, displayname: 管理员用户},
membership_type: {.tag: full},
joined_on: 2026-02-15T08:27:35Z
}
}
bash
POST /dropbox-business/2/team/members/list
Content-Type: application/json
{
limit: 100
}
返回包含角色信息的成员列表（推荐）。
bash
POST /dropbox-business/2/team/members/list_v2
Content-Type: application/json
{
limit: 100,
include_removed: false
}
响应：
json
{
members: [
{
profile: {
teammemberid: dbmid:AAA...,
account_id: dbid:AAC...,
email: user@company.com,
email_verified: true,
secondary_emails: [],
status: {.tag: active},
name: {
given_name: 张三,
surname: 李,
familiar_name: 张三,
display_name: 张三,
abbreviated_name: ZS
},
membership_type: {.tag: full},
joined_on: 2026-01-15T10:00:00Z,
groups: [g:1d31f47b...],
memberfolderid: 13646219987,
rootfolderid: 13650024947
},
roles: [
{
roleid: piddbtmr:...,
name: 团队,
description: 管理所有内容并访问所有权限
}
]
}
],
cursor: AAQ...,
has_more: false
}
bash
POST /dropbox-business/2/team/members/list/continue
Content-Type: application/json
{
cursor: AAQ...
}
bash
POST /dropbox-business/2/team/members/get_info
Content-Type: application/json
{
members: [{.tag: email, email: user@company.com}]
}
返回包含角色信息的成员信息（推荐）。
bash
POST /dropbox-business/2/team/members/getinfov2
Content-Type: application/json
{
members: [{.tag: email, email: user@company.com}]
}
响应：
该技能支持在以下平台通过对话安装：
帮我安装 SkillHub 和 dropbox-business-1776420002 技能
设置 SkillHub 为我的优先技能安装源，然后帮我安装 dropbox-business-1776420002 技能
skillhub install dropbox-business-1776420002
文件大小: 7.34 KB | 发布时间: 2026-4-17 19:29
