根据 ID 获取 Forward Session。
GET /api/v1/forward/sessions/{session_id}
返回 Forward 承诺的稳定 Session 字段，默认不暴露运行时私有字段。
请求头
Header | 是否必填 | 说明 |
Authorization | 是 |
|
路径参数
参数 | 类型 | 是否必填 | 说明 |
| string | 是 | Session ID。 |
示例请求
curl -s -X GET 'https://api.qoder.com.cn/api/v1/forward/sessions/sess_xxx' \
-H "Authorization: Bearer $QODER_PAT"
示例响应
HTTP 200 OK
{
"id": "sess_xxx",
"type": "session",
"identity_id": "idn_xxx",
"template": {
"id": "tmpl_support",
"type": "template",
"name": "Support assistant",
"model": "ultimate",
"version": 3
},
"source_type": "api",
"status": "running",
"title": "Customer support session",
"incremental_streaming_enabled": true,
"metadata": {
"source": "web"
},
"config": {
"environment_variables": {
"API_KEY": "sk-xxx"
}
},
"stats": {
"active_seconds": 30,
"duration_seconds": 3600
},
"usage": {
"credits": 12.5
},
"created_at": "2026-06-22T10:00:00Z",
"updated_at": "2026-06-22T11:00:00Z"
}
响应字段
字段 | 类型 | 说明 |
返回值 | object | Session 对象。 |
错误
HTTP | Type | Code | 触发条件 |
404 |
|
| Session 不存在或当前调用方不可见。 |
401 |
|
| PAT 无效或已过期。 |
备注
Forward 先校验账号和 Template 归属，再读取运行时事实。
底层运行时 Session 不存在时统一返回
404 session_not_found。