セッションイベントの一覧表示 - Qoder CN シリーズ - Alibaba Cloud ドキュメントセンター

Forward セッションのイベント履歴を一覧表示します。

リクエストヘッダー

ヘッダー	必須	説明
`Authorization`	はい	`Bearer <PAT>`

パスパラメーター

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

クエリパラメーター

パラメーター	型	必須	デフォルト	説明
`limit`	整数	いいえ	20	1 ページあたりの項目数。最大 100 件。
`after_id`	文字列	いいえ	-	指定されたイベント ID より後のイベントのカーソル。
`before_id`	文字列	いいえ	-	指定されたイベント ID より前のイベントのカーソル。
`order`	文字列	いいえ	`asc`	順序： `asc` または `desc`。
`type`	文字列	いいえ	-	イベントタイプによるフィルター。カンマ区切りの値が使用可能です。
`types[]`	文字列	いいえ	-	配列形式のイベントタイプフィルター。
`include_tool_calls`	ブール値	いいえ	`true`	ツール呼び出しイベントを含めます。
`include_thinking`	ブール値	いいえ	`true`	思考イベントを含めます。

リクエストの例

curl -s -X GET 'https://api.qoder.com.cn/api/v1/forward/sessions/sess_xxx/events?limit=20&order=asc' \
  -H "Authorization: Bearer $QODER_PAT"

レスポンスの例

HTTP 200 OK

{
  "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"
    }
  ],
  "first_id": "evt_xxx",
  "last_id": "evt_xxx",
  "has_more": false
}

レスポンスフィールド

フィールド	型	説明
`data`	配列	現在のページにあるイベントオブジェクトの配列。
`first_id`	文字列 \| null	このページの最初のイベントの ID。
`last_id`	文字列 \| null	このページの最後のイベントの ID。
`has_more`	ブール値	さらにレコードが残っているかどうか。

イベントフィールド

フィールド	型	説明
`id`	文字列	イベント ID。
`type`	文字列	イベントタイプ。
`session_id`	文字列	セッション ID。
`processed_at`	文字列	利用可能な場合の処理タイムスタンプ。
`content`	配列	メッセージ形式のイベントの場合に返されます。

エラー

HTTP	型	コード	原因
400	`invalid_request_error`	`invalid_event_cursor`	カーソルがこのセッションに属していません。
400	`invalid_request_error`	`invalid_pagination`	ページネーションパラメーターが無効です。
401	`authentication_error`	`TOKEN_INVALID`	個人用アクセストークン (PAT) が無効、または有効期限が切れています。
404	`not_found_error`	`session_not_found`	セッションが存在しません。

注意事項

不明なイベントタイプがあってもリクエストは失敗しません。利用可能な場合は、最小限のエンベロープで返されます。
Forward は、エージェント ID、環境 ID、リソース、ボールト、ワーカー ID、トレース、raw/debug/internal ペイロードなどのランタイムプライベートフィールドをフィルターします。

リクエストヘッダー

パスパラメーター

クエリパラメーター

リクエストの例

レスポンスの例

レスポンスフィールド

イベントフィールド

エラー

注意事項

関連 API