screenRIG
サインイン開始する

API リファレンス

コンテンツ配信 API

保護されたコンテンツとリリース資産

HTTP リファレンス。 バックエンド契約から生成。以下のエンドポイントを参照するか、OpenAPI をダウンロードしてください。

OpenAPI YAMLOpenAPI JSON問題 YAMLAPI の概要

このグループには 8 件のオペレーションがあり、api/openapi.yaml から生成されています。パス、アクション、認証で絞り込めます。各エンドポイントには入力が一覧され、展開するとリクエストテンプレートとレスポンスコードを確認できます。テンプレートには、ご自身の値とスキーマに適合する本文が必要です。

大文字のプレースホルダーをあなたの値に置き換えます。JSONリクエストの場合、request.jsonのスキーマに合うボディを保存します。Cookie例は認証済みセッションのローカルCookieジャーを使用します。

保護されたコンテンツとリリース資産

GET/screen/ad-decisions/{decision_id}

広告決定コンテンツを取得

発行された決定に結びつく1つのプライベートオブジェクトを提供します。権限はライブペアリング済みの識別子と決定の結びつきです。購入者プロジェクトとメディア ID はサーバー側で解決され、呼び出し元からは決して解決されず、オブジェクトキーや署名付き URL は公開されません。長さ0のプローブはメタデータのみ返します。

認証
runtimeCookie または nativeSessionAuthorization
リクエスト本文
なし
操作ID
getAdDecisionContent

パラメーター

名前送信する必須？説明
decision_idパス必須
範囲ヘッダーオプションV1は1つのバイト範囲のみ受け入れます。
リクエストテンプレートとレスポンス
シェル・リクエストテンプレート
curl --request GET --cookie cookies.txt --cookie-jar cookies.txt 'https://play.screenrig.ai/screen/ad-decisions/DECISION_ID'

レスポンス

ステータス意味本文とヘッダー
200決定境界付きプライベートメディアを完了。本文なし；ヘッダー：Accept-Ranges、Content-Length、ETag
2061つの標準準拠バイト範囲。本文なし；ヘッダー：Accept-Ranges、Content-Range、Content-Length、ETag
404not_found - 不明な決定です。ランタイム問題（application/problem+json）
410決定は期限切れまたはその他の理由で提供不可です。ランタイム問題（application/problem+json）
416invalid_range。ランタイム問題（application/problem+json）；ヘッダー：Content-Range、Accept-Ranges
デフォルト

Player 対応のランタイム、コンテンツ、またはプローブルートでの安定した RFC 9457 問題応答。ランタイムドキュメント形式（RuntimeProblem）。421 server_draining は Retry-After 1秒、500 not_ready または dependency_unavailable は 5秒、500 manifest_degraded は 60秒を持ちます。ハンドラーがより具体的な値を設定していない場合。

ランタイム問題（application/problem+json）
HEAD/screen/ad-decisions/{decision_id}

ヘッド広告決定コンテンツ

本文なしGETと同じ権限とメタデータ。

認証
runtimeCookie または nativeSessionAuthorization
リクエスト本文
なし
操作ID
headAdDecisionContent

パラメーター

名前送信する必須？説明
decision_idパス必須
範囲ヘッダーオプションV1は1つのバイト範囲のみ受け入れます。
リクエストテンプレートとレスポンス
シェル・リクエストテンプレート
curl --request HEAD --cookie cookies.txt --cookie-jar cookies.txt 'https://play.screenrig.ai/screen/ad-decisions/DECISION_ID'

レスポンス

ステータス意味本文とヘッダー
200メタデータのみです。本文なし；ヘッダー：Accept-Ranges、Content-Length、ETag
デフォルト

Player 対応のランタイム、コンテンツ、またはプローブルートでの安定した RFC 9457 問題応答。ランタイムドキュメント形式（RuntimeProblem）。421 server_draining は Retry-After 1秒、500 not_ready または dependency_unavailable は 5秒、500 manifest_degraded は 60秒を持ちます。ハンドラーがより具体的な値を設定していない場合。

ランタイム問題（application/problem+json）
GET/media/{media_id}

安定した保護メディアを取得

プレイリストの改訂間で共有される安定した不変のメディアURL。ランタイムセッションは認証と帯域幅計算のためにスクリーンとプロジェクトを識別します。

すべてのリクエストは、そのスクリーンの現在のコンテンツアクセス世代で望ましい、アクティブ、または期限切れでないトランジショングレース権限のメンバーシップ、またはカードデータキーの現在のドキュメント内の media:<id> 参照を必要とします。ID だけではアクセス権を与えません。ETag はバイトの sha256 の引用符付きです。

ブラウザクッキーとネイティブセッション認証は信頼されたPlayerオリジンに残り、リダイレクトや公開オブジェクトストレージアクセスは使用されません。

認証
runtimeCookie または nativeSessionAuthorization
リクエスト本文
なし
操作ID
getStableProtectedMedia

パラメーター

名前送信する必須？説明
media_idパス必須
範囲ヘッダーオプションV1は1つのバイト範囲のみ受け入れます。
Sec-Fetch-Siteヘッダーオプション
Sec-Fetch-Modeヘッダーオプション
Sec-Fetch-Destヘッダーオプション
リクエストテンプレートとレスポンス
シェル・リクエストテンプレート
curl --request GET --cookie cookies.txt --cookie-jar cookies.txt 'https://play.screenrig.ai/media/MEDIA_ID'

レスポンス

ステータス意味本文とヘッダー
200セッション認証済みの完全なプライベートメディア。ブラウザのFetch Metadataは信頼されたプレーヤーの同一オリジンのメディア／画像／動画利用を記述する必要があります。認証済みネイティブクライアントは省略可能です。本文なし；ヘッダー：Accept-Ranges、Content-Length、ETag、Content-Disposition
2061つの標準準拠バイト範囲。本文なし；ヘッダー：Accept-Ranges、Content-Range、Content-Length、ETag
416満たせない、複数、または不正な範囲。ランタイム問題（application/problem+json）；ヘッダー：Content-Range、Accept-Ranges
429クライアント、スクリーン、または組織ごとの保護されたメディアの送信制限を超えました。ランタイム問題（application/problem+json）；ヘッダー：Retry-After
デフォルト

Player 対応のランタイム、コンテンツ、またはプローブルートでの安定した RFC 9457 問題応答。ランタイムドキュメント形式（RuntimeProblem）。421 server_draining は Retry-After 1秒、500 not_ready または dependency_unavailable は 5秒、500 manifest_degraded は 60秒を持ちます。ハンドラーがより具体的な値を設定していない場合。

ランタイム問題（application/problem+json）
HEAD/media/{media_id}

ヘッド安定保護メディア

GET と同じ付与チェックを持つセッション認証済みの不変メディアメタデータで、レスポンスボディはありません。

認証
runtimeCookie または nativeSessionAuthorization
リクエスト本文
なし
操作ID
headStableProtectedMedia

パラメーター

名前送信する必須？説明
media_idパス必須
範囲ヘッダーオプションV1は1つのバイト範囲のみ受け入れます。
Sec-Fetch-Siteヘッダーオプション
Sec-Fetch-Modeヘッダーオプション
Sec-Fetch-Destヘッダーオプション
リクエストテンプレートとレスポンス
シェル・リクエストテンプレート
curl --request HEAD --cookie cookies.txt --cookie-jar cookies.txt 'https://play.screenrig.ai/media/MEDIA_ID'

レスポンス

ステータス意味本文とヘッダー
200セッション認証済みの完全なプライベートメディア。ブラウザのFetch Metadataは信頼されたプレーヤーの同一オリジンのメディア／画像／動画利用を記述する必要があります。認証済みネイティブクライアントは省略可能です。本文なし；ヘッダー：Accept-Ranges、Content-Length、ETag、Content-Disposition
2061つの標準準拠バイト範囲。本文なし；ヘッダー：Accept-Ranges、Content-Range、Content-Length、ETag
416満たせない、複数、または不正な範囲。ランタイム問題（application/problem+json）；ヘッダー：Content-Range、Accept-Ranges
429クライアント、スクリーン、または組織ごとの保護されたメディアの送信制限を超えました。ランタイム問題（application/problem+json）；ヘッダー：Retry-After
デフォルト

Player 対応のランタイム、コンテンツ、またはプローブルートでの安定した RFC 9457 問題応答。ランタイムドキュメント形式（RuntimeProblem）。421 server_draining は Retry-After 1秒、500 not_ready または dependency_unavailable は 5秒、500 manifest_degraded は 60秒を持ちます。ハンドラーがより具体的な値を設定していない場合。

ランタイム問題（application/problem+json）
GET/media/manifests/{manifest_revision}/{media_id}

保護されたメディアを取得

認証
runtimeCookie または nativeSessionAuthorization
リクエスト本文
なし
操作ID
getProtectedMedia

パラメーター

名前送信する必須？説明
manifest_revisionパス必須
media_idパス必須
範囲ヘッダーオプションV1は1つのバイト範囲のみ受け入れます。
Sec-Fetch-Siteヘッダーオプション
Sec-Fetch-Modeヘッダーオプション
Sec-Fetch-Destヘッダーオプション
リクエストテンプレートとレスポンス
シェル・リクエストテンプレート
curl --request GET --cookie cookies.txt --cookie-jar cookies.txt 'https://play.screenrig.ai/media/manifests/MANIFEST_REVISION/MEDIA_ID'

レスポンス

ステータス意味本文とヘッダー
200セッション認証済みの完全なプライベートメディア。ブラウザのFetch Metadataは信頼されたプレーヤーの同一オリジンのメディア／画像／動画利用を記述する必要があります。認証済みネイティブクライアントは省略可能です。本文なし；ヘッダー：Accept-Ranges、Content-Length、ETag、Content-Disposition
2061つの標準準拠バイト範囲。本文なし；ヘッダー：Accept-Ranges、Content-Range、Content-Length、ETag
416満たせない、複数、または不正な範囲。ランタイム問題（application/problem+json）；ヘッダー：Content-Range、Accept-Ranges
429クライアント、スクリーン、または組織ごとの保護されたメディアの送信制限を超えました。ランタイム問題（application/problem+json）；ヘッダー：Retry-After
デフォルト

Player 対応のランタイム、コンテンツ、またはプローブルートでの安定した RFC 9457 問題応答。ランタイムドキュメント形式（RuntimeProblem）。421 server_draining は Retry-After 1秒、500 not_ready または dependency_unavailable は 5秒、500 manifest_degraded は 60秒を持ちます。ハンドラーがより具体的な値を設定していない場合。

ランタイム問題（application/problem+json）
GET/screen/manifests/{manifest_revision}/releases/{release_id}/package

ネイティブ Webapp パッケージを取得

ペアリングされたネイティブプレーヤーがプロセス再起動や一時的なネットワーク障害時に認証済みの最後の正常リリースを保持できるように、1つのアップロードされたアプリケーションリリースの正規化された不変パッケージを取得します。

ペアリングデバイスクッキー、正確なスクリーングラント、マニフェストリビジョン、コンテンツアクセス世代、リリースメンバーシップ、準備済みパッケージメタデータはすべてのリクエストでチェックされます。プロジェクトトークン、匿名ランタイムクッキー、リリースクッキー、外部iframeプリミティブ、直接オブジェクトストレージアクセスはパッケージバイトの認可に使われません。

認証
pairedDeviceCookie または nativeSessionAuthorization
リクエスト本文
なし
操作ID
getNativeWebappPackage

パラメーター

名前送信する必須？説明
manifest_revisionパス必須
release_idパス必須
範囲ヘッダーオプションV1は1つのバイト範囲のみ受け入れます。
Sec-Fetch-Siteヘッダーオプション
Sec-Fetch-Modeヘッダーオプション
Sec-Fetch-Destヘッダーオプション
リクエストテンプレートとレスポンス
シェル・リクエストテンプレート
curl --request GET --cookie cookies.txt --cookie-jar cookies.txt 'https://play.screenrig.ai/screen/manifests/MANIFEST_REVISION/releases/RELEASE_ID/package'

レスポンス

ステータス意味本文とヘッダー
200正規化済みプライベートパッケージを完了。本文なし；ヘッダー：Accept-Ranges、Content-Length、Content-Type、Content-Disposition、Cache-Control、ETag、Referrer-Policy、Cross-Origin-Resource-Policy、X-Content-Type-Options、Vary
206同じ不変パッケージからの1つの標準準拠バイト範囲。本文なし；ヘッダー：Accept-Ranges、Content-Range、Content-Length、Content-Type、Content-Disposition、Cache-Control、ETag、Referrer-Policy、Cross-Origin-Resource-Policy、X-Content-Type-Options、Vary
416満たせない、複数、または不正な範囲。ランタイム問題（application/problem+json）；ヘッダー：Content-Range、Accept-Ranges
429

Player 対応のランタイムまたはコンテンツルートでの安定した rate_limited 問題応答。ランタイムドキュメント形式（RuntimeProblem）。権威ある Retry-After 間隔後にのみリトライしてください。固定ウィンドウ拒否は適用される RateLimit-Policy と RateLimit メンバーも含みます。並行性とバイト予算拒否はこれらの開示を省略します。

ランタイム問題（application/problem+json）；ヘッダー：Retry-After、RateLimit-Policy、RateLimit
デフォルト

Player 対応のランタイム、コンテンツ、またはプローブルートでの安定した RFC 9457 問題応答。ランタイムドキュメント形式（RuntimeProblem）。421 server_draining は Retry-After 1秒、500 not_ready または dependency_unavailable は 5秒、500 manifest_degraded は 60秒を持ちます。ハンドラーがより具体的な値を設定していない場合。

ランタイム問題（application/problem+json）
HEAD/screen/manifests/{manifest_revision}/releases/{release_id}/package

ヘッドネイティブWebアプリパッケージ

GETと同じ認可および不変のIDヘッダーをパッケージバイトなしで返します。

認証
pairedDeviceCookie または nativeSessionAuthorization
リクエスト本文
なし
操作ID
headNativeWebappPackage

パラメーター

名前送信する必須？説明
manifest_revisionパス必須
release_idパス必須
範囲ヘッダーオプションV1は1つのバイト範囲のみ受け入れます。
Sec-Fetch-Siteヘッダーオプション
Sec-Fetch-Modeヘッダーオプション
Sec-Fetch-Destヘッダーオプション
リクエストテンプレートとレスポンス
シェル・リクエストテンプレート
curl --request HEAD --cookie cookies.txt --cookie-jar cookies.txt 'https://play.screenrig.ai/screen/manifests/MANIFEST_REVISION/releases/RELEASE_ID/package'

レスポンス

ステータス意味本文とヘッダー
200認可された正規化パッケージメタデータ。本文なし；ヘッダー：Accept-Ranges、Content-Length、Content-Type、Content-Disposition、Cache-Control、ETag、Referrer-Policy、Cross-Origin-Resource-Policy、X-Content-Type-Options、Vary
2061バイト範囲の認可メタデータ。本文なし；ヘッダー：Accept-Ranges、Content-Range、Content-Length、Content-Type、Content-Disposition、Cache-Control、ETag、Referrer-Policy、Cross-Origin-Resource-Policy、X-Content-Type-Options、Vary
416満たせない、複数、または不正な範囲。本文なし；ヘッダー：Content-Range、Accept-Ranges
429

Player 対応のランタイムまたはコンテンツルートでの安定した rate_limited 問題応答。ランタイムドキュメント形式（RuntimeProblem）。権威ある Retry-After 間隔後にのみリトライしてください。固定ウィンドウ拒否は適用される RateLimit-Policy と RateLimit メンバーも含みます。並行性とバイト予算拒否はこれらの開示を省略します。

ランタイム問題（application/problem+json）；ヘッダー：Retry-After、RateLimit-Policy、RateLimit
デフォルト

Player 対応のランタイム、コンテンツ、またはプローブルートでの安定した RFC 9457 問題応答。ランタイムドキュメント形式（RuntimeProblem）。421 server_draining は Retry-After 1秒、500 not_ready または dependency_unavailable は 5秒、500 manifest_degraded は 60秒を持ちます。ハンドラーがより具体的な値を設定していない場合。

ランタイム問題（application/problem+json）
GET/{asset_path}

起動チケットを消費またはリリース資産を取得

正確なリリースホスト操作。チケットクエリがある場合、使い捨て30秒チケットを原子操作で消費し、Host/release/screen/content-generation/manifest/grant をバインドし、正確なホストのリリース付与クッキーのみを設定し、チケットなしの同じパスにリダイレクトします。チケットなしの場合、すべてのGET/HEADでそのクッキーを検証します。

asset_path パラメーターは貪欲です（x-screenrig-greedy-path）で、ready release ルートの下でのみ解決されます。ランタイム/プロジェクト/デバイスのクッキーやプロジェクトのベアラートークンはこの操作を認可しません。

認証
releaseLaunchTicket または releaseGrantCookie
リクエスト本文
なし
操作ID
consumeLaunchTicketOrGetReleaseAsset

パラメーター

名前送信する必須？説明
asset_pathパス必須
Sec-Fetch-Siteヘッダーオプション
Sec-Fetch-Modeヘッダーオプション
Sec-Fetch-Destヘッダーオプション
リクエストテンプレートとレスポンス
シェル・リクエストテンプレート
curl --request GET --cookie cookies.txt --cookie-jar cookies.txt 'https://r-{release_host_label}.apps.screenrig.ai/index.html'

レスポンス

ステータス意味本文とヘッダー
200正確なホスト付与認可済み不変アセット。本文なし；ヘッダー：Referrer-Policy、X-Content-Type-Options、ETag
302チケットは一度消費されました。リリース権限クッキーが発行され、チケットはロケーションから削除されました。本文なし；ヘッダー：Location、Set-Cookie、Cache-Control、Referrer-Policy
403ホスト/リリース/screen/generation/grantの誤り、期限切れ/再生されたチケット、無効なクッキー、矛盾する Fetch Metadata、または禁止されたメソッド。問題 (application/problem+json)
404リリースファイルシステムの形状を公開せずにアセットが存在しません。問題 (application/problem+json)