Inhaltszustellung: API-Referenz mit Endpunkten und Beispielen

OpenAPI YAML OpenAPI JSON Probleme YAML API-Überblick

Diese Gruppe hat 8 Operationen, generiert aus api/openapi.yaml. Filtern Sie nach Pfad, Aktion oder Authentifizierung. Jeder Endpunkt listet seine Eingaben auf; klappen Sie ihn auf, um eine Anfragevorlage und die Antwortcodes zu sehen. Die Vorlagen brauchen Ihre eigenen Werte und einen schemagültigen Anfragekörper.

Großgeschriebene Platzhalter durch Ihre Werte ersetzen. Für eine JSON-Anfrage speichern Sie einen Body, der dem Schema in request.json entspricht. Cookie-Beispiele verwenden ein lokales Cookie-Archiv aus einer authentifizierten Sitzung.

Geschützte Inhalte und Freigabe-Assets

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

Werbeentscheidungsinhalt abrufen

Dient dem einen privaten Objekt, das an eine ausgestellte Entscheidung gebunden ist. Die Autorität ist die live gekoppelte Identität plus die Entscheidungsbindung; das Käuferprojekt und die Medien-ID werden serverseitig aufgelöst, niemals vom Aufrufer, und kein Objekt-Schlüssel oder signierte URL wird veröffentlicht. Eine Sonde mit Null-Länge gibt nur Metadaten zurück.

Authentifizierung: runtimeCookie ODER nativeSessionAuthorization
Anfrageinhalt: keine
Operations-ID: getAdDecisionContent

Parameter

Name	Senden	Erforderlich?	Beschreibung
decision_id	Pfad	erforderlich
Bereich	Überschrift	optional	V1 akzeptiert nur einen Bytebereich.

Anfragevorlage und Antworten

Shell · Anfragevorlage

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

Antworten

Status	Bedeutung	Textkörper und Header
200	Entscheidungsgebundene private Medien abschließen.	kein Körper; Header: Accept-Ranges, Content-Length, ETag
206	Ein standardkonformer Bytebereich.	kein Körper; Header: Accept-Ranges, Content-Range, Content-Length, ETag
404	not_found - unbekannte Entscheidung.	RuntimeProblem (application/problem+json)
410	Entscheidung abgelaufen oder anderweitig nicht ausführbar.	RuntimeProblem (application/problem+json)
416	invalid_range.	RuntimeProblem (application/problem+json); Header: Content-Range, Accept-Ranges
Standard	Stabile RFC 9457-Fehlerantwort bei einer Player-gerichteten Laufzeit-, Inhalts- oder Probe-Route im Laufzeit-Dokumentformat (RuntimeProblem). Ein 421 server_draining enthält Retry-After von 1 Sekunde, ein 500 not_ready oder dependency_unavailable enthält 5, und ein 500 manifest_degraded enthält 60, sofern der Handler keinen spezifischeren Wert gesetzt hat.	RuntimeProblem (application/problem+json)

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

Head Ad Decision Content

Identische Autorität und Metadaten wie der GET ohne Body.

Authentifizierung: runtimeCookie ODER nativeSessionAuthorization
Anfrageinhalt: keine
Operations-ID: headAdDecisionContent

Parameter

Name	Senden	Erforderlich?	Beschreibung
decision_id	Pfad	erforderlich
Bereich	Überschrift	optional	V1 akzeptiert nur einen Bytebereich.

Anfragevorlage und Antworten

Shell · Anfragevorlage

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

Antworten

Status	Bedeutung	Textkörper und Header
200	Nur Metadaten.	kein Körper; Header: Accept-Ranges, Content-Length, ETag
Standard	Stabile RFC 9457-Fehlerantwort bei einer Player-gerichteten Laufzeit-, Inhalts- oder Probe-Route im Laufzeit-Dokumentformat (RuntimeProblem). Ein 421 server_draining enthält Retry-After von 1 Sekunde, ein 500 not_ready oder dependency_unavailable enthält 5, und ein 500 manifest_degraded enthält 60, sofern der Handler keinen spezifischeren Wert gesetzt hat.	RuntimeProblem (application/problem+json)

GET/media/{media_id}¶

Stabile geschützte Medien erhalten

Stabile unveränderliche Medien-URL, die über Playlist-Revisionen hinweg geteilt wird. Die Laufzeitsitzung identifiziert den Bildschirm und das Projekt zur Autorisierung und Bandbreitenabrechnung.

Jede Anfrage erfordert die Mitgliedschaft in dem gewünschten, aktiven oder nicht abgelaufenen Übergangs-Gnaden-Grant dieses Bildschirms in seiner aktuellen Content-Access-Generation oder eine media:<id>-Referenz im aktuellen Dokument eines Kartendaten-Schlüssels, den ein solcher Grant auflistet. IDs allein gewähren keinen Zugriff. ETag ist der zitierte sha256 der Bytes.

Browser-Cookie- und native Sitzungs-Authentifizierung bleiben auf der vertrauenswürdigen Player-Quelle; Weiterleitungen und öffentlicher Objektspeicherzugriff werden nicht verwendet.

Authentifizierung: runtimeCookie ODER nativeSessionAuthorization
Anfrageinhalt: keine
Operations-ID: getStableProtectedMedia

Parameter

Name	Senden	Erforderlich?	Beschreibung
media_id	Pfad	erforderlich
Bereich	Überschrift	optional	V1 akzeptiert nur einen Bytebereich.
Sec-Fetch-Site	Überschrift	optional
Sec-Fetch-Mode	Überschrift	optional
Sec-Fetch-Dest	Überschrift	optional

Anfragevorlage und Antworten

Shell · Anfragevorlage

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

Antworten

Status	Bedeutung	Textkörper und Header
200	Sitzungsgenehmigte vollständige private Medien. Browser Fetch Metadata muss die Verwendung vertrauenswürdiger Player für Medien/Bilder/Videos derselben Herkunft beschreiben; authentifizierte native Clients können dies weglassen.	kein Körper; Header: Accept-Ranges, Content-Length, ETag, Content-Disposition
206	Ein standardkonformer Bytebereich.	kein Körper; Header: Accept-Ranges, Content-Range, Content-Length, ETag
416	Nicht erfüllbarer, mehrfacher oder fehlerhafter Bereich.	RuntimeProblem (application/problem+json); Header: Content-Range, Accept-Ranges
429	Das Egress-Limit für geschützte Medien pro Client, Bildschirm oder Organisation wurde überschritten.	RuntimeProblem (application/problem+json); Header: Retry-After
Standard	Stabile RFC 9457-Fehlerantwort bei einer Player-gerichteten Laufzeit-, Inhalts- oder Probe-Route im Laufzeit-Dokumentformat (RuntimeProblem). Ein 421 server_draining enthält Retry-After von 1 Sekunde, ein 500 not_ready oder dependency_unavailable enthält 5, und ein 500 manifest_degraded enthält 60, sofern der Handler keinen spezifischeren Wert gesetzt hat.	RuntimeProblem (application/problem+json)

HEAD/media/{media_id}¶

Stabile geschützte Medien

Sitzungsgenehmigte unveränderliche Medienmetadaten mit denselben Berechtigungsprüfungen wie GET und ohne Antwortkörper.

Authentifizierung: runtimeCookie ODER nativeSessionAuthorization
Anfrageinhalt: keine
Operations-ID: headStableProtectedMedia

Parameter

Name	Senden	Erforderlich?	Beschreibung
media_id	Pfad	erforderlich
Bereich	Überschrift	optional	V1 akzeptiert nur einen Bytebereich.
Sec-Fetch-Site	Überschrift	optional
Sec-Fetch-Mode	Überschrift	optional
Sec-Fetch-Dest	Überschrift	optional

Anfragevorlage und Antworten

Shell · Anfragevorlage

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

Antworten

Status	Bedeutung	Textkörper und Header
200	Sitzungsgenehmigte vollständige private Medien. Browser Fetch Metadata muss die Verwendung vertrauenswürdiger Player für Medien/Bilder/Videos derselben Herkunft beschreiben; authentifizierte native Clients können dies weglassen.	kein Körper; Header: Accept-Ranges, Content-Length, ETag, Content-Disposition
206	Ein standardkonformer Bytebereich.	kein Körper; Header: Accept-Ranges, Content-Range, Content-Length, ETag
416	Nicht erfüllbarer, mehrfacher oder fehlerhafter Bereich.	RuntimeProblem (application/problem+json); Header: Content-Range, Accept-Ranges
429	Das Egress-Limit für geschützte Medien pro Client, Bildschirm oder Organisation wurde überschritten.	RuntimeProblem (application/problem+json); Header: Retry-After
Standard	Stabile RFC 9457-Fehlerantwort bei einer Player-gerichteten Laufzeit-, Inhalts- oder Probe-Route im Laufzeit-Dokumentformat (RuntimeProblem). Ein 421 server_draining enthält Retry-After von 1 Sekunde, ein 500 not_ready oder dependency_unavailable enthält 5, und ein 500 manifest_degraded enthält 60, sofern der Handler keinen spezifischeren Wert gesetzt hat.	RuntimeProblem (application/problem+json)

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

Geschützte Medien erhalten

Authentifizierung: runtimeCookie ODER nativeSessionAuthorization
Anfrageinhalt: keine
Operations-ID: getProtectedMedia

Parameter

Name	Senden	Erforderlich?	Beschreibung
manifest_revision	Pfad	erforderlich
media_id	Pfad	erforderlich
Bereich	Überschrift	optional	V1 akzeptiert nur einen Bytebereich.
Sec-Fetch-Site	Überschrift	optional
Sec-Fetch-Mode	Überschrift	optional
Sec-Fetch-Dest	Überschrift	optional

Anfragevorlage und Antworten

Shell · Anfragevorlage

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

Antworten

Status	Bedeutung	Textkörper und Header
200	Sitzungsgenehmigte vollständige private Medien. Browser Fetch Metadata muss die Verwendung vertrauenswürdiger Player für Medien/Bilder/Videos derselben Herkunft beschreiben; authentifizierte native Clients können dies weglassen.	kein Körper; Header: Accept-Ranges, Content-Length, ETag, Content-Disposition
206	Ein standardkonformer Bytebereich.	kein Körper; Header: Accept-Ranges, Content-Range, Content-Length, ETag
416	Nicht erfüllbarer, mehrfacher oder fehlerhafter Bereich.	RuntimeProblem (application/problem+json); Header: Content-Range, Accept-Ranges
429	Das Egress-Limit für geschützte Medien pro Client, Bildschirm oder Organisation wurde überschritten.	RuntimeProblem (application/problem+json); Header: Retry-After
Standard	Stabile RFC 9457-Fehlerantwort bei einer Player-gerichteten Laufzeit-, Inhalts- oder Probe-Route im Laufzeit-Dokumentformat (RuntimeProblem). Ein 421 server_draining enthält Retry-After von 1 Sekunde, ein 500 not_ready oder dependency_unavailable enthält 5, und ein 500 manifest_degraded enthält 60, sofern der Handler keinen spezifischeren Wert gesetzt hat.	RuntimeProblem (application/problem+json)

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

Native Webapp-Paket erhalten

Ruft das normalisierte unveränderliche Paket für eine hochgeladene Anwendungsfreigabe ab, damit ein gekoppelter nativer Player seine autorisierte zuletzt bekannte gute Version über Prozessneustart und vorübergehenden Netzwerkausfall hinweg beibehält.

Das gekoppelte Geräte-Cookie, exakte Bildschirmberechtigung, Manifest-Revision, Content-Access-Generation, Release-Mitgliedschaft und fertige Paket-Metadaten werden bei jeder Anfrage geprüft. Projekttoken, anonyme Runtime-Cookies, Release-Cookies, externe iframe-Primitiven und direkter Objekt-Speicherzugriff autorisieren niemals Paket-Bytes.

Authentifizierung: pairedDeviceCookie ODER nativeSessionAuthorization
Anfrageinhalt: keine
Operations-ID: getNativeWebappPackage

Parameter

Name	Senden	Erforderlich?	Beschreibung
manifest_revision	Pfad	erforderlich
release_id	Pfad	erforderlich
Bereich	Überschrift	optional	V1 akzeptiert nur einen Bytebereich.
Sec-Fetch-Site	Überschrift	optional
Sec-Fetch-Mode	Überschrift	optional
Sec-Fetch-Dest	Überschrift	optional

Anfragevorlage und Antworten

Shell · Anfragevorlage

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

Antworten

Status	Bedeutung	Textkörper und Header
200	Vollständiges normalisiertes privates Paket.	kein Körper; Header: Accept-Ranges, Content-Length, Content-Type, Content-Disposition, Cache-Control, ETag, Referrer-Policy, Cross-Origin-Resource-Policy, X-Content-Type-Options, Vary
206	Ein standardkonformer Bytebereich aus demselben unveränderlichen Paket.	kein Körper; Header: 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	Nicht erfüllbarer, mehrfacher oder fehlerhafter Bereich.	RuntimeProblem (application/problem+json); Header: Content-Range, Accept-Ranges
429	Stabiles rate_limited-Problem bei einer Player-gerichteten Laufzeit- oder Inhaltsroute im Laufzeit-Dokumentformat (RuntimeProblem). Nur nach dem autoritativen Retry-After-Intervall erneut versuchen. Ablehnungen mit festem Fenster enthalten auch die anwendbare RateLimit-Policy und RateLimit-Mitglieder; Ablehnungen wegen gleichzeitiger Nutzung und Byte-Budget enthalten diese optionalen Angaben nicht.	RuntimeProblem (application/problem+json); Header: Retry-After, RateLimit-Policy, RateLimit
Standard	Stabile RFC 9457-Fehlerantwort bei einer Player-gerichteten Laufzeit-, Inhalts- oder Probe-Route im Laufzeit-Dokumentformat (RuntimeProblem). Ein 421 server_draining enthält Retry-After von 1 Sekunde, ein 500 not_ready oder dependency_unavailable enthält 5, und ein 500 manifest_degraded enthält 60, sofern der Handler keinen spezifischeren Wert gesetzt hat.	RuntimeProblem (application/problem+json)

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

Native Webapp-Paket

Gibt dieselben Autorisierungs- und unveränderlichen Identitätsheader wie GET ohne Paketdaten zurück.

Authentifizierung: pairedDeviceCookie ODER nativeSessionAuthorization
Anfrageinhalt: keine
Operations-ID: headNativeWebappPackage

Parameter

Name	Senden	Erforderlich?	Beschreibung
manifest_revision	Pfad	erforderlich
release_id	Pfad	erforderlich
Bereich	Überschrift	optional	V1 akzeptiert nur einen Bytebereich.
Sec-Fetch-Site	Überschrift	optional
Sec-Fetch-Mode	Überschrift	optional
Sec-Fetch-Dest	Überschrift	optional

Anfragevorlage und Antworten

Shell · Anfragevorlage

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

Antworten

Status	Bedeutung	Textkörper und Header
200	Autorisierte normalisierte Paketmetadaten.	kein Körper; Header: Accept-Ranges, Content-Length, Content-Type, Content-Disposition, Cache-Control, ETag, Referrer-Policy, Cross-Origin-Resource-Policy, X-Content-Type-Options, Vary
206	Autorisierte Metadaten für einen Bytebereich.	kein Körper; Header: 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	Nicht erfüllbarer, mehrfacher oder fehlerhafter Bereich.	kein Körper; Header: Content-Range, Accept-Ranges
429	Stabiles rate_limited-Problem bei einer Player-gerichteten Laufzeit- oder Inhaltsroute im Laufzeit-Dokumentformat (RuntimeProblem). Nur nach dem autoritativen Retry-After-Intervall erneut versuchen. Ablehnungen mit festem Fenster enthalten auch die anwendbare RateLimit-Policy und RateLimit-Mitglieder; Ablehnungen wegen gleichzeitiger Nutzung und Byte-Budget enthalten diese optionalen Angaben nicht.	RuntimeProblem (application/problem+json); Header: Retry-After, RateLimit-Policy, RateLimit
Standard	Stabile RFC 9457-Fehlerantwort bei einer Player-gerichteten Laufzeit-, Inhalts- oder Probe-Route im Laufzeit-Dokumentformat (RuntimeProblem). Ein 421 server_draining enthält Retry-After von 1 Sekunde, ein 500 not_ready oder dependency_unavailable enthält 5, und ein 500 manifest_degraded enthält 60, sofern der Handler keinen spezifischeren Wert gesetzt hat.	RuntimeProblem (application/problem+json)

GET/{asset_path}¶

Launch-Ticket verbrauchen oder Release-Asset abrufen

Exakte Release-Host-Operation. Bei einer Ticket-Abfrage wird das einmalig verwendbare 30-Sekunden-Ticket atomar verbraucht, bindet Host/release/screen/content-generation/manifest/grant, setzt nur das exakte Host-Release-Grant-Cookie und leitet auf denselben Pfad ohne Ticket weiter. Ohne Ticket wird dieses Cookie bei jedem GET/HEAD validiert.

Der asset_path-Parameter ist gierig (x-screenrig-greedy-path) und wird nur unterhalb des ready release root aufgelöst. Laufzeit-/Projekt-/Geräte-Cookies und Projekt-Bearer-Tokens autorisieren diese Operation niemals.

Authentifizierung: releaseLaunchTicket ODER releaseGrantCookie
Anfrageinhalt: keine
Operations-ID: consumeLaunchTicketOrGetReleaseAsset

Parameter

Name	Senden	Erforderlich?
asset_path	Pfad	erforderlich
Sec-Fetch-Site	Überschrift	optional
Sec-Fetch-Mode	Überschrift	optional
Sec-Fetch-Dest	Überschrift	optional

Anfragevorlage und Antworten

Shell · Anfragevorlage

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

Antworten

Status	Bedeutung	Textkörper und Header
200	Exaktes Host-Genehmigtes unveränderliches Asset.	kein Körper; Header: Referrer-Policy, X-Content-Type-Options, ETag
302	Ticket einmal verwendet; Freigabe-Cookie ausgestellt; Ticket aus Standort entfernt.	kein Körper; Header: Location, Set-Cookie, Cache-Control, Referrer-Policy
403	Falscher Host/Release/screen/generation/grant, veraltetes/wiederholtes Ticket, ungültiger Cookie, widersprüchliche Fetch-Metadaten oder nicht erlaubte Methode.	Problem (application/problem+json)
404	Asset fehlt, ohne die Form des Release-Dateisystems offenzulegen.	Problem (application/problem+json)