根据 ID 获取 Forward Session。
GET /api/v1/forward/sessions/{session_id}
返回 Forward 承诺的稳定 Session 字段,默认不暴露运行时私有字段。
请求头
| Header | 是否必填 | 说明 |
|---|---|---|
| Authorization | 是 | Bearer <PAT 或 SAT> |
路径参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| session_id | string | 是 | Session ID。 |
示例请求
示例响应
HTTP 200 OK
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| 返回值 | object | Session 对象。 |
错误
| HTTP | Type | Code | 触发条件 |
|---|---|---|---|
| 404 | not_found_error | session_not_found | Session 不存在或当前调用方不可见。 |
| 401 | authentication_error | authentication_required | PAT 或 SAT 无效或已过期。 |
备注
- Forward 先校验账号和 Template 归属,再读取运行时事实。
- 运行时 Session 不存在时统一返回
404 session_not_found。