Skip to main content
Sessions

订阅 Session Event Stream

通过 SSE 订阅 Forward Session 事件流。

请求头

Header是否必填说明
Authorization是Bearer <PAT>
Accept是text/event-stream
Last-Event-ID否从该 Event ID 之后恢复订阅。

路径参数

参数类型是否必填说明
session_idstring是Session ID。

查询参数

参数类型是否必填默认值说明
typestring否-按 Event 类型过滤，支持逗号分隔。
types[]string否-数组形式的 Event 类型过滤。
include_tool_callsboolean否true是否包含工具调用类事件。
include_thinkingboolean否true是否包含思考过程事件。

示例请求

curl -s -X GET 'https://api.qoder.com.cn/api/v1/forward/sessions/sess_xxx/events/stream' \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Accept: text/event-stream"

示例响应

HTTP 200 OK 
id: evt_xxx
event: agent.message
data: {"id":"evt_xxx","type":"agent.message","session_id":"sess_xxx","content":[{"type":"text","text":"Here is the analysis result."}],"processed_at":"2026-06-22T11:00:03Z"}

响应字段

字段类型说明
idstringSSE event ID，等于 Event ID。
eventstringEvent 类型。
dataobject过滤后的 Forward Event JSON。

错误

HTTPTypeCode触发条件
400invalid_request_errorinvalid_event_cursorLast-Event-ID 不属于当前 Session。
404not_found_errorsession_not_foundSession 不存在。
401authentication_errorTOKEN_INVALIDPAT 无效或已过期。

备注

  • 增量流式由创建 Session 时的 incremental_streaming_enabled 控制，不能通过本接口临时开启。
  • 未知 Event 类型可用时会作为 envelope-only 事件转发。
  • include_thinking=false 会过滤 thinking 事件和可识别的 thinking delta。
  • include_tool_calls=false 会过滤工具调用事件和可识别的工具输入/输出 delta。
  • session&event数据结构
  • 创建 Session
  • 查询 Event 历史
操作指南
实践教程
API参考