Entrega de contenido: referencia de la API, endpoints y ejemplos

OpenAPI YAML OpenAPI JSON problemas YAML Resumen de la API

Este grupo tiene 8 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.

Contenido protegido y activos de lanzamiento

GET/screen/ad-decisions/{decision_id}¶

Obtener contenido de decisión de anuncio

Sirve el único objeto privado vinculado a una decisión emitida. La autoridad es la identidad emparejada en vivo más el vínculo de decisión; el proyecto comprador y el ID de medios se resuelven en el servidor, nunca desde el llamante, y no se publica ninguna clave de objeto ni URL firmada. Una prueba de longitud cero devuelve solo metadatos.

Autenticación: runtimeCookie O nativeSessionAuthorization
Cuerpo de la solicitud: ninguno
ID de operación: getAdDecisionContent

Parámetros

Nombre	Enviar	¿Requerido?	Descripción
decision_id	ruta	requerido
Rango	encabezado	opcional	V1 acepta solo un rango de bytes.

Plantilla y respuestas de solicitud

shell · plantilla de solicitud

curl --request GET --cookie cookies.txt --cookie-jar cookies.txt 'https://play.screenrig.ai/screen/ad-decisions/DECISION_ID'

Respuestas

Estado	Significado	Cuerpo y encabezados
200	Completar medios privados vinculados a decisión.	sin cuerpo; encabezados: Accept-Ranges, Content-Length, ETag
206	Un rango de bytes correcto según el estándar.	sin cuerpo; encabezados: Accept-Ranges, Content-Range, Content-Length, ETag
404	not_found - decisión desconocida.	RuntimeProblem (application/problem+json)
410	decisión expirada o no disponible para servir.	RuntimeProblem (application/problem+json)
416	invalid_range.	RuntimeProblem (application/problem+json); encabezados: Content-Range, Accept-Ranges
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)

HEAD/screen/ad-decisions/{decision_id}¶

Contenido de decisión de anuncios principal

Autoridad y metadatos idénticos a la GET sin cuerpo.

Autenticación: runtimeCookie O nativeSessionAuthorization
Cuerpo de la solicitud: ninguno
ID de operación: headAdDecisionContent

Parámetros

Nombre	Enviar	¿Requerido?	Descripción
decision_id	ruta	requerido
Rango	encabezado	opcional	V1 acepta solo un rango de bytes.

Plantilla y respuestas de solicitud

shell · plantilla de solicitud

curl --request HEAD --cookie cookies.txt --cookie-jar cookies.txt 'https://play.screenrig.ai/screen/ad-decisions/DECISION_ID'

Respuestas

Estado	Significado	Cuerpo y encabezados
200	Solo metadatos.	sin cuerpo; encabezados: Accept-Ranges, Content-Length, ETag
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)

GET/media/{media_id}¶

Obtener multimedia protegida estable

URL de medios inmutable estable compartida entre revisiones de listas de reproducción. La sesión de ejecución identifica la pantalla y el proyecto para autorización y contabilidad de ancho de banda.

Cada solicitud requiere membresía en la concesión de gracia de transición deseada, activa o no expirada de esa pantalla en su generación actual de acceso a contenido, o una referencia media:<id> en el documento actual de una clave de datos de tarjeta que tal concesión lista. Los IDs solos no otorgan acceso. ETag es el sha256 entre comillas de los bytes.

La cookie del navegador y la autenticación de sesión nativa permanecen en el origen confiable del Player; no se usan redirecciones ni acceso público a almacenamiento de objetos.

Autenticación: runtimeCookie O nativeSessionAuthorization
Cuerpo de la solicitud: ninguno
ID de operación: getStableProtectedMedia

Parámetros

Nombre	Enviar	¿Requerido?	Descripción
media_id	ruta	requerido
Rango	encabezado	opcional	V1 acepta solo un rango de bytes.
Sec-Fetch-Site	encabezado	opcional
Sec-Fetch-Mode	encabezado	opcional
Sec-Fetch-Dest	encabezado	opcional

Plantilla y respuestas de solicitud

shell · plantilla de solicitud

curl --request GET --cookie cookies.txt --cookie-jar cookies.txt 'https://play.screenrig.ai/media/MEDIA_ID'

Respuestas

Estado	Significado	Cuerpo y encabezados
200	Medios privados completos autorizados por sesión. Browser Fetch Metadata debe describir el uso de medios/imagen/video de reproductor confiable mismo origen; clientes nativos autenticados pueden omitirlo.	sin cuerpo; encabezados: Accept-Ranges, Content-Length, ETag, Content-Disposition
206	Un rango de bytes correcto según el estándar.	sin cuerpo; encabezados: Accept-Ranges, Content-Range, Content-Length, ETag
416	Rango insatisfacible, múltiple o mal formado.	RuntimeProblem (application/problem+json); encabezados: Content-Range, Accept-Ranges
429	Se superó el límite de salida de medios protegidos por cliente, pantalla u organización.	RuntimeProblem (application/problem+json); encabezados: Retry-After
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)

HEAD/media/{media_id}¶

Encabezado de medios protegidos estables

Metadatos inmutables de medios autorizados por sesión con las mismas verificaciones de concesión que GET y sin cuerpo de respuesta.

Autenticación: runtimeCookie O nativeSessionAuthorization
Cuerpo de la solicitud: ninguno
ID de operación: headStableProtectedMedia

Parámetros

Nombre	Enviar	¿Requerido?	Descripción
media_id	ruta	requerido
Rango	encabezado	opcional	V1 acepta solo un rango de bytes.
Sec-Fetch-Site	encabezado	opcional
Sec-Fetch-Mode	encabezado	opcional
Sec-Fetch-Dest	encabezado	opcional

Plantilla y respuestas de solicitud

shell · plantilla de solicitud

curl --request HEAD --cookie cookies.txt --cookie-jar cookies.txt 'https://play.screenrig.ai/media/MEDIA_ID'

Respuestas

Estado	Significado	Cuerpo y encabezados
200	Medios privados completos autorizados por sesión. Browser Fetch Metadata debe describir el uso de medios/imagen/video de reproductor confiable mismo origen; clientes nativos autenticados pueden omitirlo.	sin cuerpo; encabezados: Accept-Ranges, Content-Length, ETag, Content-Disposition
206	Un rango de bytes correcto según el estándar.	sin cuerpo; encabezados: Accept-Ranges, Content-Range, Content-Length, ETag
416	Rango insatisfacible, múltiple o mal formado.	RuntimeProblem (application/problem+json); encabezados: Content-Range, Accept-Ranges
429	Se superó el límite de salida de medios protegidos por cliente, pantalla u organización.	RuntimeProblem (application/problem+json); encabezados: Retry-After
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)

GET/media/manifests/{manifest_revision}/{media_id}¶

Obtener multimedia protegida

Autenticación: runtimeCookie O nativeSessionAuthorization
Cuerpo de la solicitud: ninguno
ID de operación: getProtectedMedia

Parámetros

Nombre	Enviar	¿Requerido?	Descripción
manifest_revision	ruta	requerido
media_id	ruta	requerido
Rango	encabezado	opcional	V1 acepta solo un rango de bytes.
Sec-Fetch-Site	encabezado	opcional
Sec-Fetch-Mode	encabezado	opcional
Sec-Fetch-Dest	encabezado	opcional

Plantilla y respuestas de solicitud

shell · plantilla de solicitud

curl --request GET --cookie cookies.txt --cookie-jar cookies.txt 'https://play.screenrig.ai/media/manifests/MANIFEST_REVISION/MEDIA_ID'

Respuestas

Estado	Significado	Cuerpo y encabezados
200	Medios privados completos autorizados por sesión. Browser Fetch Metadata debe describir el uso de medios/imagen/video de reproductor confiable mismo origen; clientes nativos autenticados pueden omitirlo.	sin cuerpo; encabezados: Accept-Ranges, Content-Length, ETag, Content-Disposition
206	Un rango de bytes correcto según el estándar.	sin cuerpo; encabezados: Accept-Ranges, Content-Range, Content-Length, ETag
416	Rango insatisfacible, múltiple o mal formado.	RuntimeProblem (application/problem+json); encabezados: Content-Range, Accept-Ranges
429	Se superó el límite de salida de medios protegidos por cliente, pantalla u organización.	RuntimeProblem (application/problem+json); encabezados: Retry-After
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)

GET/screen/manifests/{manifest_revision}/releases/{release_id}/package¶

Obtener paquete de app web nativa

Recupera el paquete inmutable normalizado para una versión de aplicación subida para que un reproductor nativo emparejado pueda conservar su última versión autorizada conocida a través del reinicio del proceso y la pérdida temporal de red.

La cookie del dispositivo emparejado, la concesión exacta de pantalla, la revisión del manifiesto, la generación de acceso al contenido, la membresía de lanzamiento y los metadatos del paquete listo se verifican en cada solicitud. Los tokens de proyecto, cookies anónimas de tiempo de ejecución, cookies de lanzamiento, primitivas de iframe externas y acceso directo a almacenamiento de objetos nunca autorizan bytes de paquete.

Autenticación: pairedDeviceCookie O nativeSessionAuthorization
Cuerpo de la solicitud: ninguno
ID de operación: getNativeWebappPackage

Parámetros

Nombre	Enviar	¿Requerido?	Descripción
manifest_revision	ruta	requerido
release_id	ruta	requerido
Rango	encabezado	opcional	V1 acepta solo un rango de bytes.
Sec-Fetch-Site	encabezado	opcional
Sec-Fetch-Mode	encabezado	opcional
Sec-Fetch-Dest	encabezado	opcional

Plantilla y respuestas de solicitud

shell · plantilla de solicitud

curl --request GET --cookie cookies.txt --cookie-jar cookies.txt 'https://play.screenrig.ai/screen/manifests/MANIFEST_REVISION/releases/RELEASE_ID/package'

Respuestas

Estado	Significado	Cuerpo y encabezados
200	Paquete privado normalizado completo.	sin cuerpo; encabezados: Accept-Ranges, Content-Length, Content-Type, Content-Disposition, Cache-Control, ETag, Referrer-Policy, Cross-Origin-Resource-Policy, X-Content-Type-Options, Vary
206	Un rango de bytes correcto según el estándar del mismo paquete inmutable.	sin cuerpo; encabezados: 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	Rango insatisfacible, múltiple o mal formado.	RuntimeProblem (application/problem+json); encabezados: Content-Range, Accept-Ranges
429	Problema estable rate_limited en una ruta de ejecución o contenido orientada al reproductor, en la forma del documento de ejecución (RuntimeProblem). Reintente solo después del intervalo Retry-After autorizado. Las denegaciones de ventana fija también incluyen la política RateLimit-Policy y los miembros RateLimit aplicables; las denegaciones por concurrencia y presupuesto de bytes omiten esas divulgaciones opcionales.	RuntimeProblem (application/problem+json); encabezados: Retry-After, 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)

HEAD/screen/manifests/{manifest_revision}/releases/{release_id}/package¶

Encabezado de paquete de app web nativa

Devuelve las mismas cabeceras de autorización e identidad inmutable que GET sin los bytes del paquete.

Autenticación: pairedDeviceCookie O nativeSessionAuthorization
Cuerpo de la solicitud: ninguno
ID de operación: headNativeWebappPackage

Parámetros

Nombre	Enviar	¿Requerido?	Descripción
manifest_revision	ruta	requerido
release_id	ruta	requerido
Rango	encabezado	opcional	V1 acepta solo un rango de bytes.
Sec-Fetch-Site	encabezado	opcional
Sec-Fetch-Mode	encabezado	opcional
Sec-Fetch-Dest	encabezado	opcional

Plantilla y respuestas de solicitud

shell · plantilla de solicitud

curl --request HEAD --cookie cookies.txt --cookie-jar cookies.txt 'https://play.screenrig.ai/screen/manifests/MANIFEST_REVISION/releases/RELEASE_ID/package'

Respuestas

Estado	Significado	Cuerpo y encabezados
200	Metadatos normalizados autorizados del paquete.	sin cuerpo; encabezados: Accept-Ranges, Content-Length, Content-Type, Content-Disposition, Cache-Control, ETag, Referrer-Policy, Cross-Origin-Resource-Policy, X-Content-Type-Options, Vary
206	Metadatos autorizados para un rango de bytes.	sin cuerpo; encabezados: 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	Rango insatisfacible, múltiple o mal formado.	sin cuerpo; encabezados: Content-Range, Accept-Ranges
429	Problema estable rate_limited en una ruta de ejecución o contenido orientada al reproductor, en la forma del documento de ejecución (RuntimeProblem). Reintente solo después del intervalo Retry-After autorizado. Las denegaciones de ventana fija también incluyen la política RateLimit-Policy y los miembros RateLimit aplicables; las denegaciones por concurrencia y presupuesto de bytes omiten esas divulgaciones opcionales.	RuntimeProblem (application/problem+json); encabezados: Retry-After, 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)

GET/{asset_path}¶

Consumir boleto de lanzamiento o obtener activo de lanzamiento

Operación exacta de liberación de host. Con una consulta de ticket, consume atómicamente el ticket de un solo uso de 30 segundos, vincula Host/release/screen/content-generation/manifest/grant, establece solo la cookie release-grant de host exacto y redirige a la misma ruta sin el ticket. Sin ticket, valida esa cookie en cada GET/HEAD.

El parámetro asset_path es voraz (x-screenrig-greedy-path) y se resuelve solo bajo la raíz de lanzamiento listo. Las cookies de tiempo de ejecución/proyecto/dispositivo y los tokens portadores de proyecto nunca autorizan esta operación.

Autenticación: releaseLaunchTicket O releaseGrantCookie
Cuerpo de la solicitud: ninguno
ID de operación: consumeLaunchTicketOrGetReleaseAsset

Parámetros

Nombre	Enviar	¿Requerido?
asset_path	ruta	requerido
Sec-Fetch-Site	encabezado	opcional
Sec-Fetch-Mode	encabezado	opcional
Sec-Fetch-Dest	encabezado	opcional

Plantilla y respuestas de solicitud

shell · plantilla de solicitud

curl --request GET --cookie cookies.txt --cookie-jar cookies.txt 'https://r-{release_host_label}.apps.screenrig.ai/index.html'

Respuestas

Estado	Significado	Cuerpo y encabezados
200	Activo inmutable autorizado por concesión de host exacto.	sin cuerpo; encabezados: Referrer-Policy, X-Content-Type-Options, ETag
302	Ticket consumido una vez; cookie de concesión de liberación emitida; ticket eliminado de la Ubicación.	sin cuerpo; encabezados: Location, Set-Cookie, Cache-Control, Referrer-Policy
403	Host/versión incorrectos /screen/generation/grant, ticket obsoleto/repetido, cookie inválida, Fetch Metadata contradictorio o método no permitido.	Problema (application/problem+json)
404	Activo ausente sin exponer la forma del sistema de archivos de lanzamiento.	Problema (application/problem+json)