OpenAPI YAMLOpenAPI JSON問題 YAMLAPI の概要
このグループには 4 件のオペレーションがあり、api/openapi.yaml から生成されています。パス、アクション、認証で絞り込めます。各エンドポイントには入力が一覧され、展開するとリクエストテンプレートとレスポンスコードを確認できます。テンプレートには、ご自身の値とスキーマに適合する本文が必要です。
大文字のプレースホルダーをあなたの値に置き換えます。JSONリクエストの場合、request.jsonのスキーマに合うボディを保存します。Cookie例は認証済みセッションのローカルCookieジャーを使用します。
ランタイムアプリケーション K/V
ランタイム KV 一覧
昇順のキー順で最大200件返し、ページングしません。キーが多い名前空間は部分的にしかリストされません。スクリーンの現在のコンテンツが保持するアプリケーションのメタデータをリストします。
Runtime KV は Player のランタイムセッション（kv.read、書き込みは kv.write）とスクリーンの現在の権限によって認可されます。権限はアプリケーションの準備完了リリースを保持している必要があります。ScreenRig-Primitive-Capability ヘッダーは無視されます。アップロードされたフレームはこれらのルートを呼び出さず、検証済みの親 SDK ブリッジを使用する必要があります。
パラメーター
| 名前 | 送信する | 必須？ | 説明 |
|---|---|---|---|
| application_id | パス | 必須 |
リクエストテンプレートとレスポンス
curl --request GET --cookie cookies.txt --cookie-jar cookies.txt 'https://play.screenrig.ai/screen/apps/APPLICATION_ID/kv'レスポンス
| ステータス | 意味 | 本文とヘッダー |
|---|---|---|
| 200 | マニフェスト承認済みアプリケーション KV | ランタイムKVリスト（application/json） |
| デフォルト | Player 対応のランタイム、コンテンツ、またはプローブルートでの安定した RFC 9457 問題応答。ランタイムドキュメント形式（RuntimeProblem）。421 server_draining は Retry-After 1秒、500 not_ready または dependency_unavailable は 5秒、500 manifest_degraded は 60秒を持ちます。ハンドラーがより具体的な値を設定していない場合。 | ランタイム問題（application/problem+json） |
ランタイム KV を取得
パラメーター
| 名前 | 送信する | 必須？ | 説明 |
|---|---|---|---|
| application_id | パス | 必須 | |
| キー | パス | 必須 |
リクエストテンプレートとレスポンス
curl --request GET --cookie cookies.txt --cookie-jar cookies.txt 'https://play.screenrig.ai/screen/apps/APPLICATION_ID/kv/KEY'レスポンス
| ステータス | 意味 | 本文とヘッダー |
|---|---|---|
| 200 | マニフェスト承認済みアプリケーション KV 値 | ランタイムKVエントリ（application/json） |
| デフォルト | Player 対応のランタイム、コンテンツ、またはプローブルートでの安定した RFC 9457 問題応答。ランタイムドキュメント形式（RuntimeProblem）。421 server_draining は Retry-After 1秒、500 not_ready または dependency_unavailable は 5秒、500 manifest_degraded は 60秒を持ちます。ハンドラーがより具体的な値を設定していない場合。 | ランタイム問題（application/problem+json） |
ランタイムKVをPUT
パラメーター
| 名前 | 送信する | 必須？ | 説明 |
|---|---|---|---|
| application_id | パス | 必須 | |
| キー | パス | 必須 | |
| If-Match | ヘッダー | オプション | オプションの正のリソースリビジョン。キーの作成または上書き時は省略します。提供された古いリビジョンはrevision_conflictです。 |
| Idempotency-Key | ヘッダー | オプション | 新規操作のために省略します。再試行の重複排除にキーを供給し再利用してください。CLIがキーを自動管理します。 |
リクエスト本文フィールド
| フィールド | 説明 |
|---|---|
| value_base64（必須、文字列） | maxLength：1398104 |
| content_type（任意、文字列） | デフォルト：「application/octet-stream」minLength：1 maxLength：127 |
リクエストテンプレートとレスポンス
curl --request PUT --cookie cookies.txt --cookie-jar cookies.txt --header 'Content-Type: application/json' --data '@request.json' 'https://play.screenrig.ai/screen/apps/APPLICATION_ID/kv/KEY'レスポンス
| ステータス | 意味 | 本文とヘッダー |
|---|---|---|
| 200 | ペアリングデバイスのKV変更 | ランタイムKVエントリ（application/json）；ヘッダー：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） |
ランタイムKV削除
パラメーター
| 名前 | 送信する | 必須？ | 説明 |
|---|---|---|---|
| application_id | パス | 必須 | |
| キー | パス | 必須 | |
| If-Match | ヘッダー | オプション | オプションの正のリソースリビジョン。現在のリソースを書き込む場合は省略します。提供された古いリビジョンはrevision_conflictです。 |
| Idempotency-Key | ヘッダー | オプション | 新規操作のために省略します。再試行の重複排除にキーを供給し再利用してください。CLIがキーを自動管理します。 |
リクエストテンプレートとレスポンス
curl --request DELETE --cookie cookies.txt --cookie-jar cookies.txt 'https://play.screenrig.ai/screen/apps/APPLICATION_ID/kv/KEY'レスポンス
| ステータス | 意味 | 本文とヘッダー |
|---|---|---|
| 204 | ペアリングデバイスのKV削除 | 本文なし；ヘッダー：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） |