OpenAPI YAMLOpenAPI JSONproblemas YAMLResumen de la API
Este grupo tiene 4 operaciones, generadas a partir de api/openapi.yaml. Filtre por ruta, acción o autenticación. Cada endpoint indica sus entradas; despliéguelo para ver una plantilla de solicitud y los códigos de respuesta. Las plantillas necesitan sus propios valores y un cuerpo válido según el esquema.
Reemplace los marcadores en mayúsculas con sus valores. Para una solicitud JSON, guarde un cuerpo que coincida con el esquema en request.json. Los ejemplos de cookies usan un frasco de cookies local de una sesión autenticada.
K/V de aplicación en tiempo de ejecución
Listar KV de tiempo de ejecución
Devuelve como máximo 200 entradas en orden ascendente de clave y no pagina; un espacio de nombres con más claves solo se lista parcialmente. Lista metadatos para una aplicación que el contenido actual de la pantalla contiene.
El KV de tiempo de ejecución está autorizado por la sesión de tiempo de ejecución del Player (kv.read, y kv.write para escrituras) y la concesión actual de la pantalla, que debe tener una versión lista de la aplicación; se ignora un encabezado ScreenRig-Primitive-Capability. Los cuadros subidos nunca llaman a estas rutas y deben usar el puente SDK padre validado.
Parámetros
| Nombre | Enviar | ¿Requerido? | Descripción |
|---|---|---|---|
| application_id | ruta | requerido |
Plantilla y respuestas de solicitud
curl --request GET --cookie cookies.txt --cookie-jar cookies.txt 'https://play.screenrig.ai/screen/apps/APPLICATION_ID/kv'Respuestas
| Estado | Significado | Cuerpo y encabezados |
|---|---|---|
| 200 | KV de aplicación autorizada por manifiesto | RuntimeKVList (application/json) |
| predeterminado | Respuesta estable RFC 9457 a problemas en una ruta de ejecución, contenido o sonda orientada al reproductor, en la forma del documento de ejecución (RuntimeProblem). Un 421 server_draining lleva Retry-After de 1 segundo, un 500 not_ready o dependency_unavailable lleva 5, y un 500 manifest_degraded lleva 60, a menos que el manejador establezca un valor más específico. | RuntimeProblem (application/problem+json) |
Obtener KV de ejecución
Parámetros
| Nombre | Enviar | ¿Requerido? | Descripción |
|---|---|---|---|
| application_id | ruta | requerido | |
| key | ruta | requerido |
Plantilla y respuestas de solicitud
curl --request GET --cookie cookies.txt --cookie-jar cookies.txt 'https://play.screenrig.ai/screen/apps/APPLICATION_ID/kv/KEY'Respuestas
| Estado | Significado | Cuerpo y encabezados |
|---|---|---|
| 200 | Valor KV de aplicación autorizada por manifiesto | RuntimeKVEntry (application/json) |
| predeterminado | Respuesta estable RFC 9457 a problemas en una ruta de ejecución, contenido o sonda orientada al reproductor, en la forma del documento de ejecución (RuntimeProblem). Un 421 server_draining lleva Retry-After de 1 segundo, un 500 not_ready o dependency_unavailable lleva 5, y un 500 manifest_degraded lleva 60, a menos que el manejador establezca un valor más específico. | RuntimeProblem (application/problem+json) |
Poner KV de ejecución
Parámetros
| Nombre | Enviar | ¿Requerido? | Descripción |
|---|---|---|---|
| application_id | ruta | requerido | |
| key | ruta | requerido | |
| If-Match | encabezado | opcional | Revisión positiva opcional de recurso. Omitir para crear o sobrescribir una clave; una revisión obsoleta suministrada es revision_conflict. |
| Idempotency-Key | encabezado | opcional | Omitir para una operación nueva. Proporcione y reutilice una clave para deduplicar reintentos; el CLI gestiona las claves automáticamente. |
Campos del cuerpo de la solicitud
| Campo | Descripción |
|---|---|
| value_base64 (requerido, cadena) | maxLength: 1398104 |
| content_type (opcional, cadena) | predeterminado: "application/octet-stream" minLength: 1 maxLength: 127 |
Plantilla y respuestas de solicitud
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'Respuestas
| Estado | Significado | Cuerpo y encabezados |
|---|---|---|
| 200 | Mutación KV de dispositivo vinculado | RuntimeKVEntry (application/json); encabezados: RateLimit-Policy, RateLimit |
| predeterminado | Respuesta estable RFC 9457 a problemas en una ruta de ejecución, contenido o sonda orientada al reproductor, en la forma del documento de ejecución (RuntimeProblem). Un 421 server_draining lleva Retry-After de 1 segundo, un 500 not_ready o dependency_unavailable lleva 5, y un 500 manifest_degraded lleva 60, a menos que el manejador establezca un valor más específico. | RuntimeProblem (application/problem+json) |
Eliminar KV en tiempo de ejecución
Parámetros
| Nombre | Enviar | ¿Requerido? | Descripción |
|---|---|---|---|
| application_id | ruta | requerido | |
| key | ruta | requerido | |
| If-Match | encabezado | opcional | Revisión positiva opcional de recurso. Omitir para escribir el recurso actual; una revisión obsoleta suministrada es revision_conflict. |
| Idempotency-Key | encabezado | opcional | Omitir para una operación nueva. Proporcione y reutilice una clave para deduplicar reintentos; el CLI gestiona las claves automáticamente. |
Plantilla y respuestas de solicitud
curl --request DELETE --cookie cookies.txt --cookie-jar cookies.txt 'https://play.screenrig.ai/screen/apps/APPLICATION_ID/kv/KEY'Respuestas
| Estado | Significado | Cuerpo y encabezados |
|---|---|---|
| 204 | Eliminación KV de dispositivo vinculado | sin cuerpo; encabezados: RateLimit-Policy, RateLimit |
| predeterminado | Respuesta estable RFC 9457 a problemas en una ruta de ejecución, contenido o sonda orientada al reproductor, en la forma del documento de ejecución (RuntimeProblem). Un 421 server_draining lleva Retry-After de 1 segundo, un 500 not_ready o dependency_unavailable lleva 5, y un 500 manifest_degraded lleva 60, a menos que el manejador establezca un valor más específico. | RuntimeProblem (application/problem+json) |