分页列出会话当前已挂载的资源。
前提
已完成 Endpoint 与鉴权配置,详见API 总览与认证。
接口
GET /sessions/{session_id}/resources
路径参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
session_id | 是 | string | 会话 ID,格式 sesn_<ULID> |
Query 参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
limit | 否 | integer | 每页数量,最大 100,默认 20 |
page | 否 | string | 分页游标(opaque token)。首次不传,后续传上一次响应返回的游标 |
请求示例
响应
响应包含 data(会话资源对象数组)与 next_page(下一页游标,无更多数据时为 null)。
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
data | array<object> | 资源对象数组 |
data[].id | string | 资源 ID,格式 sesrsc_<ULID> |
data[].type | string | 资源类型,固定为 file |
data[].file_id | string | 内部副本的文件 ID |
data[].mount_path | string | 加上 /mnt/session/uploads/ 前缀后的完整挂载路径 |
data[].created_at | string | 创建时间,ISO 8601 |
data[].updated_at | string | 最近更新时间,ISO 8601 |
next_page | string | 下一页游标,原样传入 page 参数续翻;无更多数据时为 null |
request_id | string | 本次请求的唯一标识 |
错误码
| 状态码 | 错误码 | 说明 |
|---|---|---|
| 400 | InvalidParameter | Required parameter missing or invalid. |
| 401 | InvalidApiKey | Invalid API-key provided. |