Forward Files API 接口说明。
描述
根据 File ID 获取单个 File 的元数据。
路径
GET /api/v1/forward/files/{file_id}
请求头
| 头部 | 必选 | 说明 |
|---|---|---|
Authorization | 是 | Bearer <PAT 或 SAT> |
路径参数
| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
file_id | string | 是 | 要查询的 File ID。 |
示例请求
示例响应
HTTP 200 OK
响应字段
响应为 File 对象。
错误码
| HTTP | type | 触发条件 |
|---|---|---|
| 400 | invalid_request_error | 请求体、路径参数或查询参数非法。 |
| 401 | authentication_error | 缺少或无效的认证令牌。 |
| 403 | permission_error | 当前调用方无权访问该资源。 |
| 404 | not_found_error | 资源不存在或不可见。 |
| 500/502/503 | api_error | Forward 或依赖服务失败。 |