列出可用 Provider(目录)
授权
通过 Authorization: Bearer <token> header 传用户 JWT 或
oag_ User API Key。两者都由 openapi-gateway 对 Auth
service 验证。
JWT 与 API Key 都是 user-scoped:每个 key(以及每个 JWT) 绑定到唯一 owner,所有路由都自动放开该 owner 名下的全部资源。 跨租户访问由 handler 内的 owner-ACL 拦截 —— API 表面没有 per-route scope 词汇。
v1.1.0 已移除: 历史 scope 词汇(
agents:*/tasks:*/files:*/instances:*)以及403 insufficient_scope错误码已下线。已签发的oag_key 自动获得 owner 全权限, 无需重建。之前显式传scopes调用createAPIKey的 SDK 客户端可以直接删除该参数。详见文末 changelog 迁移说明。
响应
标准 { success, data } 信封;data 是
ProviderCatalogItem
数组,每项含一个
meta
块(id、name、description、version)和一个
capabilities
块(camelCase 布尔字段加 maxDurationSec / costModel)。
Mintlify 默认把外层渲染成 object[],展开 "Show child attributes"
就能看到完整字段树 —— item 本身是强类型的。