訂閱 Session Event Stream - Qoder CN 系列

通過 SSE 訂閱 Forward Session 事件流。

要求標頭

Header	是否必填	說明
Authorization	是	`Bearer <PAT>`
Accept	是	`text/event-stream`
Last-Event-ID	否	從該 Event ID 之後恢複訂閱。

路徑參數

參數	類型	是否必填	說明
`session_id`	string	是	Session ID。

查詢參數

參數	類型	是否必填	預設值	說明
`type`	string	否	-	按 Event 類型過濾，支援逗號分隔。
`types[]`	string	否	-	數組形式的 Event 類型過濾。
`include_tool_calls`	boolean	否	true	是否包含工具調用類事件。
`include_thinking`	boolean	否	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"}

響應欄位

欄位	類型	說明
`id`	string	SSE event ID，等於 Event ID。
`event`	string	Event 類型。
`data`	object	過濾後的 Forward Event JSON。

錯誤

HTTP	Type	Code	觸發條件
400	`invalid_request_error`	`invalid_event_cursor`	`Last-Event-ID` 不屬於當前 Session。
404	`not_found_error`	`session_not_found`	Session 不存在。
401	`authentication_error`	`authentication_required`	PAT 無效或已到期。

備忘

增量流式由建立 Session 時的 incremental_streaming_enabled 控制，不能通過本介面臨時開啟。
未知 Event 類型可用時會作為 envelope-only 事件轉寄。
include_thinking=false 會過濾 thinking 事件和可識別的 thinking delta。
include_tool_calls=false 會過濾工具呼叫事件和可識別的工具輸入/輸出 delta。

Qoder CN 系列：訂閱 Session Event Stream

要求標頭

路徑參數

查詢參數

樣本請求

樣本響應

響應欄位

錯誤

備忘

相關