分页列出指定 Forward Session 中的执行 Thread。
GET /api/v1/forward/sessions/{session_id}/threads
Thread 是 Session 运行时中的执行分支。协调器主 Thread 和它创建的子 Thread 都使用同一数据结构。
请求头
| Header | 是否必填 | 说明 |
|---|---|---|
| Authorization | 是 | Bearer <PAT 或 SAT> |
路径参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| session_id | string | 是 | sess_ 前缀的 Session ID。 |
查询参数
| 参数 | 类型 | 是否必填 | 默认值 | 说明 |
|---|---|---|---|---|
| limit | integer | 否 | 20 | 分页大小，范围为 1–100。 |
| after_id | string | 否 | - | 返回该 Thread ID 之后的记录。 |
| before_id | string | 否 | - | 返回该 Thread ID 之前的记录。 |
after_id 和 before_id 不能同时传入。结果顺序固定为升序。
该接口不支持 order、statuses、statuses[] 或 include_archived。即使这些参数的值为空，也会返回 400 invalid_request。
示例请求
示例响应
| 字段 | 类型 | 说明 |
|---|---|---|
| data | array | 当前页的 Thread 对象。 |
| first_id | string | null | 当前页第一个 Thread 的 ID；当前页为空时为 null。 |
| last_id | string | null | 当前页最后一个 Thread 的 ID；当前页为空时为 null。 |
| has_more | boolean | 是否还有更多记录。 |
错误
| HTTP | Type | Code | 触发条件 |
|---|---|---|---|
| 400 | invalid_request | invalid_limit | limit 不是 1–100 的整数。 |
| 400 | invalid_request | invalid_pagination | 同时传入 after_id 和 before_id。 |
| 400 | invalid_request | invalid_request | 传入该接口不支持的 selector。 |
| 401 | authentication_error | authentication_required | PAT 或 SAT 无效或已过期。 |
| 404 | not_found | session_not_found | Session 不存在或当前调用方不可见。 |
| 502 | api_error | runtime_unavailable | Thread 运行服务暂时不可用。 |
备注
- 父 Session 活跃时，列表不包含已归档 Thread；父 Session 已归档时，列表可包含已归档 Thread。
- 已知 Thread ID 时，可通过获取 Thread 接口读取其最终状态。