All Products
Search
Document Center

Seri Qoder CN:Alirkan event sesi

Last Updated:Jul 04, 2026

Berlangganan aliran event sesi Forward menggunakan SSE.

Header permintaan

Header

Wajib

Deskripsi

Authorization

Ya

Bearer <PAT>

Accept

Ya

text/event-stream

Last-Event-ID

Tidak

Lanjutkan setelah Event ID ini.

Parameter path

Parameter

Tipe

Wajib

Deskripsi

session_id

string

Ya

ID Sesi.

Parameter kueri

Parameter

Tipe

Wajib

Bawaan

Deskripsi

type

string

Tidak

-

Filter berdasarkan tipe Event. Mendukung nilai yang dipisahkan koma.

types[]

string

Tidak

-

Filter tipe Event dalam bentuk array.

include_tool_calls

boolean

Tidak

true

Sertakan event pemanggilan tool.

include_thinking

boolean

Tidak

true

Sertakan event thinking.

Contoh permintaan

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"

Contoh respons

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"}

Contoh streaming inkremental

Jika Sesi dibuat dengan incremental_streaming_enabled=true, aliran tersebut dapat mencakup event inkremental sebelum event final 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"}

Bidang respons

Bidang

Deskripsi

id

ID event SSE. Sama dengan ID Event.

event

Tipe event.

data

JSON Event Forward yang telah difilter.

Kesalahan

HTTP

Tipe

Kode

Pemicu

400

invalid_request_error

invalid_event_cursor

Last-Event-ID tidak termasuk dalam Sesi ini.

401

authentication_error

TOKEN_INVALID

PAT tidak valid atau telah kedaluwarsa.

404

not_found_error

session_not_found

Sesi tidak ditemukan.

Catatan

  • Streaming inkremental dikendalikan oleh permintaan pembuatan Sesi dan tidak dapat diaktifkan melalui endpoint ini.

  • Event dengan tipe yang tidak dikenal diteruskan sebagai event yang hanya berisi envelope jika tersedia.

  • include_thinking=false menyaring event thinking dan delta thinking yang dapat dikenali.

  • include_tool_calls=false menyaring event penggunaan tool serta delta input/output tool yang dapat dikenali.