OpenAPI YAMLOpenAPI JSONProbleme YAMLAPI-Überblick
Diese Gruppe hat 12 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.
Player-Kopplung und Sitzungen
Pairing-Sitzung starten
Erstellt eine fleet-weite ablaufende Kopplungssitzung und setzt das temporäre HttpOnly Secure SameSite=Strict Kopplungs-Cookie. Eine nicht vertrauenswürdige Origin oder eine browserübergreifende Anfrage wird mit forbidden abgelehnt, bevor Rate-Limit oder Kopplungsstatus erstellt werden.
Anfragevorlage und Antworten
curl --request POST 'https://play.screenrig.ai/screen/pairing-sessions'Antworten
| Status | Bedeutung | Textkörper und Header |
|---|---|---|
| 201 | Exakter sechsstelliger Kopplungscode und Ablaufdatum. | PairingSession (application/json); Header: Cache-Control, RateLimit-Policy, RateLimit |
| 403 | 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) |
| 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 |
| 500 | 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) |
| 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) |
Stream Pairing Events
Anfragevorlage und Antworten
curl --request GET --cookie cookies.txt --cookie-jar cookies.txt 'https://play.screenrig.ai/stream/pairing-events'Antworten
| Status | Bedeutung | Textkörper und Header |
|---|---|---|
| 200 | Authentifizierter temporärer Pairing-SSE. Die terminale pairing.claimed-Daten sind PairingClaimedEvent und enthalten nur eine nicht geheime Abschluss-Nonce. | string (text/event-stream); Header: Cache-Control, X-Accel-Buffering |
| 401 | 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) |
| 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) |
Kopplungssitzung abschließen
Anfrageinhalt-Felder
| Feld | Beschreibung |
|---|---|
| completion_nonce (erforderlich, Zeichenfolge) | Muster: "^[A-Za-z0-9_-]{43}$" |
Anfragevorlage und Antworten
curl --request POST --cookie cookies.txt --cookie-jar cookies.txt --header 'Content-Type: application/json' --data '@request.json' 'https://play.screenrig.ai/screen/pairing-sessions/complete'Antworten
| Status | Bedeutung | Textkörper und Header |
|---|---|---|
| 200 | Cookie des verbundenen Geräts ausgegeben; der Player erstellt anschließend die gewöhnliche verbundene Laufzeitsitzung. | PairingCompletion (application/json); Header: Cache-Control, RateLimit-Policy, RateLimit |
| 400 | 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) |
| 401 | 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) |
| 403 | 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) |
| 404 | 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) |
| 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 |
| 500 | 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) |
| 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) |
Anonyme Laufzeitsitzung erstellen
Anfrageinhalt-Felder
| Feld | Beschreibung |
|---|---|
| public_id (erforderlich, Zeichenkette) | |
| Wiedergabe (optional, PlaybackHandshake) | Optionales Wiedergabe-Handshake, das ein Player bei mint erklärt. Es ist ein Hinweis, der Verhalten auswählt, niemals Autorisierung: unbekannte Mitglieder und Einträge falschen Typs werden ignoriert, und ein Wert, der kein Objekt ist, verhandelt nichts. Die mint-Antwort spiegelt die unterstützte Schnittmenge als PlaybackGrant wider. adslot-v1 wird nur an gepaarte Sitzungen vergeben. |
| Player (optional, PlayerIdentity) | Die Selbstidentifikation des Players wird nur auf den drei Mint-Routen gesendet (docs/player-compatibility.md §3.1). Sie ist ein Hinweis und niemals eine Autorisierung und wird nicht durch den nativen Nachweis abgedeckt. Sie wird tolerant gelesen: Unbekannte Mitglieder werden ignoriert, ein ungültiges optionales Mitglied wird eigenständig verworfen, und ein Player, der kein Objekt ist oder keine gültige Art hat, erklärt nichts. Sie ist niemals ein 400. Ein gekoppelter Mint speichert sie auf dem Bildschirm für das Operator-Flotten-Histogramm. |
Anfragevorlage und Antworten
curl --request POST --header 'Content-Type: application/json' --data '@request.json' 'https://play.screenrig.ai/screen/sessions'Antworten
| Status | Bedeutung | Textkörper und Header |
|---|---|---|
| 201 | Nur lesendes Laufzeit-Sitzungscookie | RuntimeSession (application/json); Header: RateLimit-Policy, RateLimit |
| 404 | 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) |
| 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) |
Gerätelaufzeitsitzung erstellen
Anfrageinhalt-Felder
| Feld | Beschreibung |
|---|---|
| public_id (optional, Zeichenkette) | minLength: 1 |
| Wiedergabe (optional, PlaybackHandshake) | Optionales Wiedergabe-Handshake, das ein Player bei mint erklärt. Es ist ein Hinweis, der Verhalten auswählt, niemals Autorisierung: unbekannte Mitglieder und Einträge falschen Typs werden ignoriert, und ein Wert, der kein Objekt ist, verhandelt nichts. Die mint-Antwort spiegelt die unterstützte Schnittmenge als PlaybackGrant wider. adslot-v1 wird nur an gepaarte Sitzungen vergeben. |
| Player (optional, PlayerIdentity) | Die Selbstidentifikation des Players wird nur auf den drei Mint-Routen gesendet (docs/player-compatibility.md §3.1). Sie ist ein Hinweis und niemals eine Autorisierung und wird nicht durch den nativen Nachweis abgedeckt. Sie wird tolerant gelesen: Unbekannte Mitglieder werden ignoriert, ein ungültiges optionales Mitglied wird eigenständig verworfen, und ein Player, der kein Objekt ist oder keine gültige Art hat, erklärt nichts. Sie ist niemals ein 400. Ein gekoppelter Mint speichert sie auf dem Bildschirm für das Operator-Flotten-Histogramm. |
Anfragevorlage und Antworten
curl --request POST --cookie cookies.txt --cookie-jar cookies.txt --header 'Content-Type: application/json' --data '@request.json' 'https://play.screenrig.ai/screen/device-sessions'Antworten
| Status | Bedeutung | Textkörper und Header |
|---|---|---|
| 201 | Verbundene Laufzeitsitzung | RuntimeSession (application/json) |
| 409 | 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) |
| 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) |
Native Pairing-Sitzung starten
Erstellt eine native Kopplungssitzung aus einem Player Ed25519 öffentlichen Schlüssel. Unbeanspruchte native Kopplungen dauern 72 Stunden. Eine erfolgreiche Beanspruchung reserviert einen Bildschirm und speichert dauerhaft verschlüsselte Zustellungen unabhängig vom Ablauf des Locators. Der öffentliche Schlüssel wird erst nach unterschriebener Fertigstellung für genau diese Kopplungsdaten und Nonce an ein Projekt gebunden.
Cookies, Abfrageanmeldeinformationen, Cross-Site-Ursprünge und Autorisierung werden abgelehnt. Exakte Idempotency-Key-Wiederholung geht neuer Missbrauchserkennung voraus. Die Antwort setzt niemals ein Cookie. Ein bereits gebundener oder explizit zurückgezogener öffentlicher Schlüssel gibt enrollment_bound zurück.
Parameter
| Name | Senden | Erforderlich? | Beschreibung |
|---|---|---|---|
| Idempotency-Key | Überschrift | erforderlich |
Anfrageinhalt-Felder
| Feld | Beschreibung |
|---|---|
| kid (erforderlich, string) | Muster: "^[A-Za-z0-9_-]{43}$" |
| public_key (erforderlich, PlayerPublicKey) | |
| Signatur (erforderlich, Zeichenfolge) | minLength: 80 maxLength: 4096 |
| Host (optional, RuntimeHostHint) | Der optionale native Host-Hinweis beim Start des Pairings, beim Abschluss des Pairings und bei der Identitätssitzungserstellung. Er benennt ein Gerät und ist niemals eine Autorisierung. Sie wird tolerant gelesen (docs/player-compatibility.md §1.1.1): unbekannte Mitglieder werden ignoriert, ein fehlerhaftes Feld oder Fähigkeiten-Eintrag wird verworfen, maximal 32 Fähigkeiten werden behalten, und ein Wert, der kein Objekt ist oder eine Plattform außerhalb des Musters, verwirft den gesamten Hinweis. Keiner dieser Fälle lehnt die Anfrage ab. Ein Player sendet weiterhin nur die registrierten Plattformwerte und die unten aufgeführten Mitglieder, da ein Pre-Contract-Backend alles andere ablehnt. |
| fleet_link (optional, Zeichenkette) | Optionales Flottenlink-Secret aus dem Fragment der Player-URL (#fleet=). Ein gültiger, aktivierter Link, der nicht abgelaufen ist, ordnet diese Kopplungssitzung sofort seinem Projekt zu oder stellt den früheren Bildschirm des Geräts wieder her; fleet_link in der Antwort gibt an, was von beidem geschehen ist. Wie host wird er tolerant gelesen: Ein fehlerhafter oder unbekannter Wert lehnt den Start nie ab. pattern: "^srfl_[A-Za-z0-9_-]{43}$" |
Anfragevorlage und Antworten
curl --request POST --header 'Idempotency-Key: REQUEST_ID' --header 'Content-Type: application/json' --data '@request.json' 'https://play.screenrig.ai/screen/native/pairing-sessions'Antworten
| Status | Bedeutung | Textkörper und Header |
|---|---|---|
| 201 | Native Kopplungscode plus temporäre ScreenRig-Pairing-Anmeldeinformationen; kein Set-Cookie. | NativePairingSession (application/json); Header: Cache-Control, RateLimit-Policy, RateLimit |
| 400 | 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) |
| 403 | 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) |
| 409 | 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) |
| 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 |
| 500 | 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) |
| 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) |
Stream Native Pairing Events
Nur native Kopplung SSE, authentifiziert durch genau einen ScreenRig-Pairing-Authorization-Header. Cookies und Abfrageanmeldeinformationen werden abgelehnt. Das Endereignis enthält nur den nicht-geheimen Abschluss-Nonce.
Anfragevorlage und Antworten
curl --request GET --header 'Authorization: ScreenRig-Pairing PAIRING' 'https://play.screenrig.ai/stream/native/pairing-events'Antworten
| Status | Bedeutung | Textkörper und Header |
|---|---|---|
| 200 | Authentifizierter nativer Pairing-SSE, dessen Terminaldaten PairingClaimedEvent sind. | string (text/event-stream); Header: Cache-Control, X-Accel-Buffering |
| 401 | 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) |
| 403 | 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) |
| 404 | 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) |
| 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 |
| 500 | 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) |
| 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) |
Native Kopplungssitzung abschließen
Vervollständigt das native Pairing mit einem Completion-Nonce und einem EdDSA-kompakten JWS (op=pairing.complete), dessen request_hash die genaue Pairing-Anmeldeinformation und den Completion-Nonce bindet. Kein Cookie wird akzeptiert oder gesetzt. Kein ScreenRig-Device-Credential wird ausgegeben. Der Player prägt als Nächstes ScreenRig-Session aus einem Besitznachweis.
Anfrageinhalt-Felder
| Feld | Beschreibung |
|---|---|
| kid (optional, string) | Muster: "^[A-Za-z0-9_-]{43}$" |
| completion_nonce (erforderlich, Zeichenfolge) | Muster: "^[A-Za-z0-9_-]{43}$" |
| public_key (erforderlich, PlayerPublicKey) | |
| Signatur (erforderlich, Zeichenfolge) | Kompakter EdDSA JWS mit op=pairing.complete und request_hash, der die genaue Kopplungsberechtigung und den Abschluss-Nonce bindet. minLength: 80 maxLength: 4096 |
| Host (optional, RuntimeHostHint) | Der optionale native Host-Hinweis beim Start des Pairings, beim Abschluss des Pairings und bei der Identitätssitzungserstellung. Er benennt ein Gerät und ist niemals eine Autorisierung. Sie wird tolerant gelesen (docs/player-compatibility.md §1.1.1): unbekannte Mitglieder werden ignoriert, ein fehlerhaftes Feld oder Fähigkeiten-Eintrag wird verworfen, maximal 32 Fähigkeiten werden behalten, und ein Wert, der kein Objekt ist oder eine Plattform außerhalb des Musters, verwirft den gesamten Hinweis. Keiner dieser Fälle lehnt die Anfrage ab. Ein Player sendet weiterhin nur die registrierten Plattformwerte und die unten aufgeführten Mitglieder, da ein Pre-Contract-Backend alles andere ablehnt. |
Anfragevorlage und Antworten
curl --request POST --header 'Authorization: ScreenRig-Pairing PAIRING' --header 'Content-Type: application/json' --data '@request.json' 'https://play.screenrig.ai/screen/native/pairing-sessions/complete'Antworten
| Status | Bedeutung | Textkörper und Header |
|---|---|---|
| 200 | Native Kopplungsabschluss; kein Set-Cookie und keine Geräteanmeldeinformationen. | NativePairingCompletion (application/json); Header: Cache-Control, RateLimit-Policy, RateLimit |
| 400 | 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) |
| 401 | 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) |
| 403 | 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) |
| 404 | 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) |
| 409 | 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) |
| 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 |
| 500 | 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) |
| 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) |
Native Identity Challenge erstellen
Gibt eine kurzlebige Nonce aus, die an einen einzelnen Player-öffentlichen Schlüssel-Fingerabdruck gebunden ist. Cookies, Abfrageanmeldeinformationen und Autorisierung werden abgelehnt.
Anfrageinhalt-Felder
| Feld | Beschreibung |
|---|---|
| kid (erforderlich, string) | RFC 7638 SHA-256 JWK Daumenabdruck. Muster: "^[A-Za-z0-9_-]{43}$" |
| public_key (optional, PlayerPublicKey) | |
| op (erforderlich, String) | Erlaubt: "pairing.start", "pairing.complete", "session.mint", "identity.reset" |
| request_hash (erforderlich, Zeichenfolge) | Muster: "^[0-9a-f]{64}$" |
Anfragevorlage und Antworten
curl --request POST --header 'Content-Type: application/json' --data '@request.json' 'https://play.screenrig.ai/screen/native/identity/challenges'Antworten
| Status | Bedeutung | Textkörper und Header |
|---|---|---|
| 201 | Challenge-Nonce für einen EdDSA-kompakten JWS-Beweis; kein Set-Cookie. | NativeIdentityChallenge (application/json); Header: Cache-Control, RateLimit-Policy, RateLimit |
| 400 | 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) |
| 404 | 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) |
| 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 |
| 500 | 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) |
| 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) |
Native Identity Laufzeitsitzung erstellen
Überprüft einen EdDSA-kompakten JWS (op=session.mint) gegen den registrierten öffentlichen Schlüssel und gibt eine signierte sieben-Tage-ScreenRig-Session zurück. Gekoppelte Player erneuern sich nach einem Tag mit Jitter über denselben signierten Mint; die Erneuerung ersetzt die Anmeldeinformationen, ohne einen bestehenden Laufzeit-Stream zu schließen. Erneuerungs-Metadaten sind für Leser optional und erfordern kein Player-Update.
Cookies werden weder akzeptiert noch gesetzt. Exakte Idempotency-Key-Wiederholung geht neuer Missbrauchserkennung voraus. Ein archivierter Bildschirm erstellt weiterhin eine Sitzung, damit der Player das archivierte Glas anzeigen kann. Sitzungs-Erstellung erfordert die exakte dauerhafte Projekt- und Bildschirmbindung, die durch signierten Abschluss hergestellt wurde; ausstehende Anspruchsangebote haben keine Sitzungsberechtigung.
Exakte Wiedergabe überprüft diese Bindung erneut und lehnt zurückgezogene Identitäten ab.
Parameter
| Name | Senden | Erforderlich? | Beschreibung |
|---|---|---|---|
| Idempotency-Key | Überschrift | erforderlich |
Anfrageinhalt-Felder
| Feld | Beschreibung |
|---|---|
| kid (erforderlich, string) | Muster: "^[A-Za-z0-9_-]{43}$" |
| public_key (erforderlich, PlayerPublicKey) | |
| Signatur (erforderlich, Zeichenfolge) | Kompakter EdDSA JWS mit op=session.mint. minLength: 80 maxLength: 4096 |
| Host (optional, RuntimeHostHint) | Der optionale native Host-Hinweis beim Start des Pairings, beim Abschluss des Pairings und bei der Identitätssitzungserstellung. Er benennt ein Gerät und ist niemals eine Autorisierung. Sie wird tolerant gelesen (docs/player-compatibility.md §1.1.1): unbekannte Mitglieder werden ignoriert, ein fehlerhaftes Feld oder Fähigkeiten-Eintrag wird verworfen, maximal 32 Fähigkeiten werden behalten, und ein Wert, der kein Objekt ist oder eine Plattform außerhalb des Musters, verwirft den gesamten Hinweis. Keiner dieser Fälle lehnt die Anfrage ab. Ein Player sendet weiterhin nur die registrierten Plattformwerte und die unten aufgeführten Mitglieder, da ein Pre-Contract-Backend alles andere ablehnt. |
| Wiedergabe (optional, PlaybackHandshake) | Optionales Wiedergabe-Handshake, das ein Player bei mint erklärt. Es ist ein Hinweis, der Verhalten auswählt, niemals Autorisierung: unbekannte Mitglieder und Einträge falschen Typs werden ignoriert, und ein Wert, der kein Objekt ist, verhandelt nichts. Die mint-Antwort spiegelt die unterstützte Schnittmenge als PlaybackGrant wider. adslot-v1 wird nur an gepaarte Sitzungen vergeben. |
| Player (optional, PlayerIdentity) | Die Selbstidentifikation des Players wird nur auf den drei Mint-Routen gesendet (docs/player-compatibility.md §3.1). Sie ist ein Hinweis und niemals eine Autorisierung und wird nicht durch den nativen Nachweis abgedeckt. Sie wird tolerant gelesen: Unbekannte Mitglieder werden ignoriert, ein ungültiges optionales Mitglied wird eigenständig verworfen, und ein Player, der kein Objekt ist oder keine gültige Art hat, erklärt nichts. Sie ist niemals ein 400. Ein gekoppelter Mint speichert sie auf dem Bildschirm für das Operator-Flotten-Histogramm. |
Anfragevorlage und Antworten
curl --request POST --header 'Idempotency-Key: REQUEST_ID' --header 'Content-Type: application/json' --data '@request.json' 'https://play.screenrig.ai/screen/native/identity/sessions'Antworten
| Status | Bedeutung | Textkörper und Header |
|---|---|---|
| 201 | Verbundenes nativen Laufzeitsitzung; kein Set-Cookie. | NativeRuntimeSession (application/json); Header: Cache-Control, RateLimit-Policy, RateLimit |
| 400 | 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) |
| 401 | 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) |
| 403 | 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) |
| 404 | 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) |
| 409 | 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) |
| 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 |
| 500 | 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) |
| 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) |
Laufzeitsitzung für Bildschirmlink erstellen
Stellt eine siebentägige ScreenRig-Session aus dem Geheimnis des Bildschirmlinks in der Adresse des Players aus (der srsl_-Wert nach #screen= in https://play.<domain>/player/#screen=…), für einen Browser, der keinen Speicher behält. Der Player sendet das Geheimnis bei jedem Laden und erneut zur Verlängerung; er hält weder Schlüssel noch Kopplung.
Der Geräteschlüssel-Claim der Sitzung trägt die ID des Links, sodass Ersetzen oder Löschen des Links sie sofort an der API und am Edge beendet. Cookies werden weder akzeptiert noch gesetzt. Die exakte Wiederholung eines Idempotency-Key geht jeder neuen Missbrauchsprüfung voraus. Ein archivierter Bildschirm stellt weiterhin eine Sitzung aus, damit der Player den archivierten Zustand anzeigen kann.
Ein ersetzter, gelöschter oder unbekannter Link ergibt screen_link_invalid (401, Aktion clear_lkg). Ein vorhandenes host ersetzt den gespeicherten Host-Hinweis; player ersetzt den gespeicherten Player.
Parameter
| Name | Senden | Erforderlich? | Beschreibung |
|---|---|---|---|
| Idempotency-Key | Überschrift | erforderlich |
Anfrageinhalt-Felder
| Feld | Beschreibung |
|---|---|
| screen_link (erforderlich, String) | Muster: "^srsl_[A-Za-z0-9_-]{43}$" |
| Host (optional, RuntimeHostHint) | Der optionale native Host-Hinweis beim Start des Pairings, beim Abschluss des Pairings und bei der Identitätssitzungserstellung. Er benennt ein Gerät und ist niemals eine Autorisierung. Sie wird tolerant gelesen (docs/player-compatibility.md §1.1.1): unbekannte Mitglieder werden ignoriert, ein fehlerhaftes Feld oder Fähigkeiten-Eintrag wird verworfen, maximal 32 Fähigkeiten werden behalten, und ein Wert, der kein Objekt ist oder eine Plattform außerhalb des Musters, verwirft den gesamten Hinweis. Keiner dieser Fälle lehnt die Anfrage ab. Ein Player sendet weiterhin nur die registrierten Plattformwerte und die unten aufgeführten Mitglieder, da ein Pre-Contract-Backend alles andere ablehnt. |
| Wiedergabe (optional, PlaybackHandshake) | Optionales Wiedergabe-Handshake, das ein Player bei mint erklärt. Es ist ein Hinweis, der Verhalten auswählt, niemals Autorisierung: unbekannte Mitglieder und Einträge falschen Typs werden ignoriert, und ein Wert, der kein Objekt ist, verhandelt nichts. Die mint-Antwort spiegelt die unterstützte Schnittmenge als PlaybackGrant wider. adslot-v1 wird nur an gepaarte Sitzungen vergeben. |
| Player (optional, PlayerIdentity) | Die Selbstidentifikation des Players wird nur auf den drei Mint-Routen gesendet (docs/player-compatibility.md §3.1). Sie ist ein Hinweis und niemals eine Autorisierung und wird nicht durch den nativen Nachweis abgedeckt. Sie wird tolerant gelesen: Unbekannte Mitglieder werden ignoriert, ein ungültiges optionales Mitglied wird eigenständig verworfen, und ein Player, der kein Objekt ist oder keine gültige Art hat, erklärt nichts. Sie ist niemals ein 400. Ein gekoppelter Mint speichert sie auf dem Bildschirm für das Operator-Flotten-Histogramm. |
Anfragevorlage und Antworten
curl --request POST --header 'Idempotency-Key: REQUEST_ID' --header 'Content-Type: application/json' --data '@request.json' 'https://play.screenrig.ai/screen/link-sessions'Antworten
| Status | Bedeutung | Textkörper und Header |
|---|---|---|
| 201 | Verbundenes nativen Laufzeitsitzung; kein Set-Cookie. | NativeRuntimeSession (application/json); Header: Cache-Control, RateLimit-Policy, RateLimit |
| 400 | 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) |
| 401 | 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) |
| 403 | 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) |
| 409 | 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) |
| 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 |
| 500 | 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) |
| 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) |
Native Identität zurücksetzen
Der Reset auf dem Player wird nur durch eine ausdrücklich bestätigte Bedieneraktion auf dem Gerät ausgelöst. Fehlgeschlagenes Pairing, Session-Erstellung oder Netzwerkzugriff lösen diese Operation nie automatisch aus oder löschen den lokalen Schlüssel des Players. Der Endpunkt überprüft ein EdDSA-kompaktes JWS (op=identity.reset).
Der an diesen Schlüssel gebundene Bildschirm wird mit archive_reason device_reset archiviert (bereits archiviert: unverändert), und der Schlüssel bleibt daran gebunden: Ein Gerät, das den Schlüssel noch hält, erzeugt eine archivierte Sitzung (dunkles Glas) und setzt diese beim Entarchivieren ohne erneutes Koppeln fort, und der Schlüssel kann keine neue Kopplung starten (enrollment_bound).
Ausstehende native Anspruchsangebote für den Schlüssel werden zurückgezogen. Ein Schlüssel, der nie einen Bildschirm gebunden hat oder bereits durch Bildschirmwiederherstellung außer Dienst gestellt wurde, wird stattdessen endgültig: Er kann keine Sitzungen mehr koppeln oder erstellen, und das Zurücksetzen eines außer Dienst gestellten Schlüssels berührt niemals den Bildschirm, den sein Nachfolger besitzt.
Wenn das angemeldete Projekt gelöscht wurde, macht ein signierter Reset den verwaisten Schlüssel terminal, ohne einen anderen Bildschirm zu archivieren, sodass das Gerät neu gekoppelt werden kann. Nach einer verlorenen Antwort behält der Player seinen lokalen Schlüssel und kann es mit einer neuen Herausforderung und frischem signiertem Nachweis erneut versuchen.
Ein Netzwerkfehler allein bestätigt kein Zurücksetzen oder autorisiert das Löschen dieses Schlüssels (docs/player-compatibility.md §5.1). Kein Projekt-Bearer. Cookies werden weder akzeptiert noch gesetzt.
Anfrageinhalt-Felder
| Feld | Beschreibung |
|---|---|
| kid (erforderlich, string) | Muster: "^[A-Za-z0-9_-]{43}$" |
| public_key (erforderlich, PlayerPublicKey) | |
| Signatur (erforderlich, Zeichenfolge) | Kompakter EdDSA JWS. minLength: 80 maxLength: 4096 |
Anfragevorlage und Antworten
curl --request POST --header 'Content-Type: application/json' --data '@request.json' 'https://play.screenrig.ai/screen/native/identity/reset'Antworten
| Status | Bedeutung | Textkörper und Header |
|---|---|---|
| 204 | Zurücksetzung aufgezeichnet: Ein an ein Live-Projekt gebundener Bildschirm archiviert mit erhaltenem Schlüssel; ein gelöschtes Projekt, ungebundener oder außer Dienst gestellter Schlüssel machte das Terminal; oder ein unbekannter Schlüssel antwortete als idempotente No-Op, die nichts archiviert. Ein authentifizierter Wiederholungsversuch von einem dieser Vorgänge gelingt ebenfalls. Kein Set-Cookie. | kein Körper; Header: Cache-Control, RateLimit-Policy, RateLimit |
| 400 | 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) |
| 401 | 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) |
| 404 | 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) |
| 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 |
| 500 | 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) |
| 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) |