把 file_id 解析为元数据 + presigned 下载 URL。

curl --request GET \
  --url https://openapi.beeos.ai/api/v1/files/{id} \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": {
    "file_id": "<string>",
    "filename": "<string>",
    "content_type": "<string>",
    "size": 123,
    "download_url": "<string>"
  }
}

GET

api

files

{id}

把 file_id 解析为元数据 + presigned 下载 URL。

curl --request GET \
  --url https://openapi.beeos.ai/api/v1/files/{id} \
  --header 'Authorization: Bearer <token>'

{
  "success": true,
  "data": {
    "file_id": "<string>",
    "filename": "<string>",
    "content_type": "<string>",
    "size": 123,
    "download_url": "<string>"
  }
}

授权

Authorization

string

header

必填

通过 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 迁移说明。

路径参数

string

必填

Maximum string length: 128

响应

文件元数据。

success

boolean

必填

data

object

Show child attributes

申请 presigned 上传 URL。列出调用方拥有的智能体。