プロジェクトイベント API

耐久性のあるプロジェクトイベントをシーケンス順に一覧表示

ページングは連続しています：返されたnext_cursorをafterとして渡し、ページが停止した正確な位置から続行します。next_cursorは最後に返されたイベントのカーソルで、新しいイベントがすでに存在し、履歴の終わりではnullです。limitはデフォルト50で1〜200を受け入れ、それ以外はinvalid_requestでlimitを指定するerrors[]メンバーを返します。

オフセットページングはサポートされていません。source=logは代わりにPlayerログをリストします：条件レポートは受信時間昇順で(runtime.reported)、screen_idと重大度でフィルタし、期間はデフォルトで過去24時間、最大31日です。

カーソルは不透明です：サーバーがプレーヤーログを保持する場所によりlg1_またはev1_です。ページが返したものを返してください。別種のカーソルはinvalid_requestでフィールド名付きで拒否されます。プレーヤーログ記録はシーケンスを持たず、GET /stream/projectに含まれず、Webhookに配信されません。

レコードはPlayerログキューが受け入れ、プロジェクトのイベント保持に保存されると承認されます。最後のカーソルとデフォルトウィンドウでポーリングが続きます。Playerログレコードはデフォルト（source=project）リストには含まれません。fromとtoはsourceがlogでない限りinvalid_requestで拒否されます。

プロジェクトリストはscreen_id、playlist_id、application_idを受け取り、1つのスクリーン、プレイリスト、またはアプリケーションのイベントを読み取ります。すべて認証情報のプロジェクトにスコープされます（idはどのイベントを読むかを示し、誰のかは示しません）：screen_idはそのスクリーンをリソースとするイベント、playlist_idはそのプレイリストをリソースとするイベントとdetails.playlist_id（それを取るスクリーン）を名前に持つイベント、application_idはそのアプリケーションをリソースとするイベントとapplication_idをリソースに持つイベント（リリースやキー/バリューエントリ）です。

種類のIDでない値はフィールド名を指定して invalid_request で拒否されます。playlist_id と application_id は source=log で拒否されます。ログはスクリーンにのみ属します。

両方のソースは resource_id、type、severity（最低限）を取り、それらを組み合わせ、IDフィルターとページングと組み合わせます。Playerログレコードは、resource がそのスクリーンである runtime.reported レコードです。したがって、そのスクリーンでない resource_id または runtime.reported を除外する type は空のページを返します。before（または order=desc）は最新を先にページングし、next_cursor は返された最も古い項目のカーソルで、before として渡されるとより古い項目に進みます。

fromなしの最新優先source=logページはデフォルトの24時間を超え、プロジェクトのイベント保持が保持する最古記録まで遡ります。1リクエストあたり最大31日間。最新優先source=logページはlimit未満または0件のレコードを含み、next_cursorを持つことがあります。nullは保持ログの終わりで終了します。

スクリーンに限定された呼び出し元（docs/screen-scope.md）は、フィルターされたフィードを読み取ります。対象は、スコープ内のスクリーンのイベント、見ることができるスクリーンフォルダー（自身のフォルダー、その上位と内側のフォルダー。screen.moved は移動先がスコープ内にある場合のみ）のイベント、キャンペーン、プレイリスト、メディア、アプリケーション、カードのイベント、および playlist_change レビューです。

それ以外のイベントはすべて除外されるため、ページに含まれるイベントは limit より少なくなることがあり、next_cursor があっても0件になることさえあります。next_cursor でページ送りを続けてください。source=log にはスコープ内の screen_id が必要です。プロジェクト自体に関するイベントは送信されません。

リプレイ可能なプロジェクトのリッスンストリーム。プレーヤーのログレコード（runtime.reported）は GET /api/events?source=log で読み取り、このストリームには含まれません。このリクエストを開くと、リッスン購読として1クレジットかかります。クレジットヘッダーは省略されます。以降の課金対象イベントは1件につき1クレジットです。screen.*、runtime.*、alert_mute.*、application.event は免除されます。

ハートビートとリトライ前文は課金されません。stream.cursor と stream.resync_required は課金対象です。デビットの冪等性は sse-event:<project_id>:<sequence> であり、再接続再生は無料です。未払いの課金イベントは書き込まれず、ストリームは閉じます。

ダッシュボードセッションで開いたストリームは、ダッシュボードのAPIリクエストと同様に、課金されません（開始もそのイベントも）。ただし、プロジェクトのストリームスロットを1つ使用します。スクリーンに限定された呼び出し元（docs/screen-scope.md）は GET /api/events と同じフィルターされたフィードを受け取ります。破棄されたイベントのフレームは送信されず、stream.cursor は位置を進め続けます。

スコープはストリームが開かれるときに読み取られ、移動またはフォルダーイベントのときにフォルダーツリーが再び読み取られます。絞り込まれたスコープは、開いているストリームに、再接続時に適用されます。