Qoder CN シリーズ:セッションイベントのストリーミング

リクエストヘッダー

ヘッダー	必須	説明
Authorization	はい	Bearer <PAT>
Accept	はい	text/event-stream
Last-Event-ID	いいえ	このイベント ID の後から再開します。

パスパラメーター

パラメーター	タイプ	必須	説明
session_id	文字列	はい	セッション ID。

クエリパラメーター

パラメーター	タイプ	必須	デフォルト	説明
type	文字列	いいえ	-	イベントタイプでフィルタリングします。カンマ区切りの値がサポートされています。
types[]	文字列	いいえ	-	配列形式のイベントタイプフィルター。
include_tool_calls	ブール値	いいえ	true	ツールコールイベントを含めます。
include_thinking	ブール値	いいえ	true	思考イベントを含めます。

リクエストの例

curl -N -X GET 'https://api.qoder.com.cn/api/v1/forward/sessions/sess_xxx/events/stream?include_thinking=false' \
  -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"}

インクリメンタルストリーミングの例

セッションが incremental_streaming_enabled=true で作成された場合、ストリームには最後の agent.message の前に増分イベントが含まれる場合があります。

id: evt_start_xxx
event: agent.message_start
data: {"id":"evt_start_xxx","type":"agent.message_start","session_id":"sess_xxx","message_id":"msg_xxx","created_at":"2026-06-22T11:00:01Z"}

id: evt_delta_xxx
event: agent.content_block_delta
data: {"id":"evt_delta_xxx","type":"agent.content_block_delta","session_id":"sess_xxx","message_id":"msg_xxx","index":0,"delta":{"type":"text_delta","text":"Here"},"created_at":"2026-06-22T11:00:01Z"}

レスポンスフィールド

フィールド	説明
id	SSE イベント ID。イベント ID と同じです。
event	イベントタイプ。
data	フィルタリングされた Forward イベント JSON。

エラー

HTTP	タイプ	コード	トリガー
400	invalid_request_error	invalid_event_cursor	Last-Event-IDはこのセッションに属していません。
401	authentication_error	TOKEN_INVALID	PAT が無効または期限切れです。
404	not_found_error	session_not_found	セッションが存在しません。

注意事項

• インクリメンタルストリーミングはセッション作成リクエストによって制御され、このエンドポイントで有効化することはできません。

• 未知のイベントタイプは、利用可能な場合はエンベロープのみのイベントとして転送されます。

• include_thinking=false は、思考イベントと認識可能な思考差分を除外します。

• include_tool_calls=false は、ツール使用イベントと認識可能なツールの入出力差分をフィルターします。

関連 API

• セッションの作成

• イベント履歴の一覧表示