Forward Files API 接口说明。
描述
根据 File ID 获取单个 File 的元数据。
路径
GET /api/v1/forward/files/{file_id}
请求头
| 头部 | 必选 | 说明 |
|---|---|---|
Authorization | 是 | Bearer <PAT 或 SAT> |
路径参数
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
file_id | string | 是 | 要查询的 File ID。 |
查询参数
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
identity_id | string | 否 | 仅在操作 Identity 归属资源时使用；PAT 可通过 Query 显式传入，不传时为管理员视角；SAT 由凭证确定归属，任何 SAT 显式携带该参数（包括空值）返回 HTTP 400。详见 Identity 归属。 |
示例请求
示例响应
HTTP 200 OK
响应字段
响应为 File 对象。
错误码
| HTTP | type | 触发条件 |
|---|---|---|
| 400 | invalid_request_error | 请求体、路径参数或查询参数非法；包括 SAT 显式携带 Query identity_id（含空值）。 |
| 401 | authentication_error | 缺少或无效的认证令牌。 |
| 403 | permission_error | 管理员 Scope 发生 Owner mismatch，或下游服务拒绝访问。 |
| 404 | not_found_error | File 不存在或在当前 Identity Scope 不可见；PAT 指定的 Identity 无效、已禁用、已删除或越权。 |
| 500/502/503 | api_error | Forward 或依赖服务失败。 |