Documentazione

Riferimento API

Trova un endpoint, verifica cosa richiede e comprendi il risultato. Queste sono le operazioni HTTP usate dal plugin screenRIG, dai lettori e dalla dashboard.

Pubblicare su uno schermo? Inizia con la configurazione del plugin e la guida CLI. Usa questo riferimento quando hai bisogno delle richieste sottostanti.

Riferimento HTTP. Generato dal contratto backend. Esplora gli endpoint qui sotto o scarica OpenAPI.

Scegli il servizio giusto

L’endpoint determina sia l’URL base sia la credenziale. I modelli di richiesta qui sotto usano l’URL del servizio dichiarato.

Cosa stai facendoServizioAutenticazione
Gestione di schermi e contenutiapi.screenrig.aiToken bearer agente
Esecuzione di un Playerplay.screenrig.aiCookie browser o credenziali native del Player
Gestire un accesso e i progettiscreenrig.ai/dashboardCookie della dashboard
Provisioning delle persone da un provider di identitàapi.screenrig.ai/scim/v2Token SCIM dell’organizzazione
Caricamento di una release dell’applicazioneIl suo host esatto sotto apps.screenrig.aiAvvia ticket o cookie di release

I lettori nativi usano ScreenRig-Pairing durante la configurazione e ScreenRig-Session dopo. Queste richieste non devono includere cookie. Gli endpoint browser usano i propri cookie.

Nomi di autenticazione usati di seguito
projectBearer
Il token agente attivo usato dal CLI incluso, associato esattamente a un progetto.
aree di capacità
Ogni credenziale agente porta un set fisso di aree: screens, content, playlists, advertising, reports e project. Una credenziale chiama solo rotte nelle sue aree; reports legge anche ogni area. Una richiesta che nomina un’area mancante restituisce 403 forbidden con dettaglio "Questa credenziale agente manca della capacità <name>." Collega una nuova installazione agente con le capacità necessarie per recuperare.
revocableAgentBearer
Il token agente chiamante, accettato per ritentare la propria disconnessione.
cookie di associazione, dispositivo e runtime
Credenziali Player browser. Ogni endpoint specifica quale cookie accetta.
cookie sessione dashboard
La sessione della persona connessa e il progetto selezionato. Il cookie separato __Host-screenrig-signup lega iscrizione con link-invito, verifica email, opzioni credenziali e accettazione. Nessuno dei cookie è una credenziale agente. Una persona che può approvare crea e sostituisce playlist con essa dall’editor di pagine del dashboard.
primitiveCapability
Accesso a breve termine allo storage chiave/valore di un’applicazione da una primitiva playlist.
demoSession
Una sessione demo sito web privata, separata da credenziali progetto e dashboard. Il sito la imposta dopo l’ingresso o un invito privato; gli identificatori di flusso non autorizzano mai l’accesso.
scimBearer
Un token di provisioning SCIM dell’organizzazione, accettato solo dalle rotte /scim/v2. Non è mai una credenziale di progetto, agente o dashboard.
ssoTransaction
Il cookie che lega un accesso single sign-on al browser che lo ha avviato.
operatorBearer
Accesso operatore di servizio.

Persone, progetti e inviti

Una persona ha un login e può appartenere a molti progetti. L’enrollment crea sempre un nuovo progetto e invia un invito membro progetto all’indirizzo di contatto. L’agente propone un nome progetto; ogni token agente resta vincolato a quel progetto.

Il dashboard elenca i progetti della persona e cambia il progetto selezionato per operazioni autenticate da cookie. Email personale e passkey appartengono all’accesso, non al progetto.

Gli inviti condividono un flusso di creazione, elenco, revoca e accettazione. I membri del progetto ricevono l’email per impostazione predefinita; un link membro esplicitamente richiesto viene restituito solo al suo creatore. Gli inviti per acquirenti di annunci sono solo via email. Gli inviti email scadono dopo sette giorni e i link membri dopo ventiquattro ore. Una nuova persona crea una passkey; una persona esistente accede prima di accettare. La registrazione tramite link verifica l’email della persona prima di creare un accesso.

Il reset dell’accesso è solo via casella di posta, scade dopo un’ora e sostituisce le credenziali di accesso della persona revocando le altre sessioni. La richiesta di conferma non rivela se un’email ha un accesso. Aprire il dashboard è una navigazione, non un’autorizzazione.

Semantica comune delle richieste

  • Idempotenza: quando un endpoint accetta Idempotency-Key, riutilizza quella chiave e la richiesta identica dopo una risposta persa; una discrepanza restituisce 409 idempotency_mismatch.
  • Revisioni: quando un endpoint richiede If-Match, invia la revisione corrente della risorsa; scritture obsolete restituiscono 412 revision_conflict.
  • Cursori: i cursori lista e SSE sono opachi.
  • Operazioni: i caricamenti possono iniziare in receiving, poi usare queued, running, succeeded, failed o cancelled.
  • SSE: riprendi con l’ultimo cursore o Last-Event-ID. Un frame stream.resync_required significa rifetch dello stato autorevole e ripresa al cursore head fornito.
  • Limiti: le capacità pubblicano limiti attivi; il rate limiting restituisce 429 rate_limited.

La persistenza delle credenziali appartiene al flusso del plugin. La CLI inclusa legge la configurazione della piattaforma fuori dalla directory plugin sostituibile.

Carica cicli di vita

Applicazioni

Invia un archivio deterministico già costruito e attendi la convalida, l’estrazione e la pubblicazione immutabile. screenRIG gestisce l’output statico confezionato.

Contenuti multimediali

Dichiarare tipo, dimensione e hash esatti; seguire il metodo PUT raw firmato e le intestazioni alla lettera; confermare e attendere. Trattare URL firmati e intestazioni come credenziali.

Runtime e contenuti protetti

Associazione, sessioni dispositivo/runtime, manifesti, report, eventi, ticket di lancio e KV runtime risiedono sull’origine attendibile del lettore. I media del manifesto supportano intervalli definiti dal contratto; le risorse di rilascio usano host isolati esatti. Le sessioni native autorizzate ricevono pacchetti webapp immutabili normalizzati tramite il percorso protetto legato a manifesto e rilascio.

I contenuti seguono l’autorità dello schermo corrente. Rilascio, pacchetto e accesso K/V derivano dalle concessioni del manifesto dello schermo corrente; i media sono serviti a uno schermo il cui progetto li possiede. L’autorità del pacchetto nativo vincola lo schermo corrente, la revisione del manifesto, l’identità del rilascio, l’hash del pacchetto, dimensione, tipo e sessione del dispositivo; l’archiviazione resta privata e la consegna resta mediata dal server.

Inventario endpoint completo

740 operazioni in 41 gruppi, generate da api/openapi.yaml. Ogni gruppo ha una pagina propria con parametri, campi della richiesta, modello di richiesta e risposte di ogni operazione.

Metadati del servizio, capacità e ricerca nella documentazione

6 operazioni con i relativi parametri, modelli di richiesta e risposte.

Progetti, inviti e accesso

147 operazioni con i relativi parametri, modelli di richiesta e risposte.

Piani, saldo crediti ed estratti conto

6 operazioni con i relativi parametri, modelli di richiesta e risposte.

Installazioni e connessioni agente

3 operazioni con i relativi parametri, modelli di richiesta e risposte.

Accesso OAuth, token e revoca

10 operazioni con i relativi parametri, modelli di richiesta e risposte.

Single sign-on: rotte di accesso, provider di identità e politica

13 operazioni con i relativi parametri, modelli di richiesta e risposte.

Provisioning utenti: SCIM 2.0, token e associazioni di gruppo

24 operazioni con i relativi parametri, modelli di richiesta e risposte.

Clienti del servizio

9 operazioni con i relativi parametri, modelli di richiesta e risposte.

Applicazioni e operazioni

11 operazioni con i relativi parametri, modelli di richiesta e risposte.

Caricamenti media

38 operazioni con i relativi parametri, modelli di richiesta e risposte.

Playlist

16 operazioni con i relativi parametri, modelli di richiesta e risposte.

Schermi

84 operazioni con i relativi parametri, modelli di richiesta e risposte.

Campagne

10 operazioni con i relativi parametri, modelli di richiesta e risposte.

Importazione programmazione: fogli di righe di programmazione

3 operazioni con i relativi parametri, modelli di richiesta e risposte.

Revisioni delle modifiche dell’agente

7 operazioni con i relativi parametri, modelli di richiesta e risposte.

Reti e campagne pubblicitarie private

46 operazioni con i relativi parametri, modelli di richiesta e risposte.

Commenti

9 operazioni con i relativi parametri, modelli di richiesta e risposte.

Note condivise dagli agenti del progetto

5 operazioni con i relativi parametri, modelli di richiesta e risposte.

Archiviazione chiave/valore applicazione

9 operazioni con i relativi parametri, modelli di richiesta e risposte.

  • Elenca KV GET /api/applications/{application_id}/kv
  • Ottieni KV GET /api/applications/{application_id}/kv/{key}
  • Inserisci KV PUT /api/applications/{application_id}/kv/{key}
  • Elimina KV DELETE /api/applications/{application_id}/kv/{key}
  • Elenca webhook KV GET /api/applications/{application_id}/kv-webhooks
  • Crea KVWebhook POST /api/applications/{application_id}/kv-webhooks
  • Elimina KVWebhook DELETE /api/applications/{application_id}/kv-webhooks/{webhook_id}
  • Ruota KVWebhook Secret POST /api/applications/{application_id}/kv-webhooks/{webhook_id}/rotate-secret
  • Ricevi KVWebhook POST /api/applications/{application_id}/kv-webhooks/{webhook_id}/write

Dati scheda per schede integrate

22 operazioni con i relativi parametri, modelli di richiesta e risposte.

Origini dati: indirizzi che mantengono aggiornata una scheda

10 operazioni con i relativi parametri, modelli di richiesta e risposte.

Dashboard BI: connessioni e viste di Power BI, Tableau e pagine web con accesso

14 operazioni con i relativi parametri, modelli di richiesta e risposte.

Connessioni: l’accesso riutilizzabile di un progetto a Microsoft e Google

9 operazioni con i relativi parametri, modelli di richiesta e risposte.

Eventi durevoli progetto

2 operazioni con i relativi parametri, modelli di richiesta e risposte.

Notifiche: avvisi via e-mail e webhook firmati in caso di cambiamenti di stato degli schermi

13 operazioni con i relativi parametri, modelli di richiesta e risposte.

Alert: problemi aperti degli schermi, riconoscimento, posticipo e silenziamenti

6 operazioni con i relativi parametri, modelli di richiesta e risposte.

Report: riepiloghi per cartella e tag, file CSV, XLSX e PDF e invii programmati via email

8 operazioni con i relativi parametri, modelli di richiesta e risposte.

Registro di audit: ogni modifica di configurazione con il suo prima e dopo, una catena di hash da verificare ed esportazione in CSV, XLSX e PDF

4 operazioni con i relativi parametri, modelli di richiesta e risposte.

Webhook: consegna eventi firmata

9 operazioni con i relativi parametri, modelli di richiesta e risposte.

Trigger alert CAP

12 operazioni con i relativi parametri, modelli di richiesta e risposte.

Aggregati di riproduzione

4 operazioni con i relativi parametri, modelli di richiesta e risposte.

Feedback: bug e richieste di funzionalità

6 operazioni con i relativi parametri, modelli di richiesta e risposte.

Assistenza

9 operazioni con i relativi parametri, modelli di richiesta e risposte.

Richieste e prenotazioni demo del sito web

7 operazioni con i relativi parametri, modelli di richiesta e risposte.

Passaggio browser homepage

6 operazioni con i relativi parametri, modelli di richiesta e risposte.

Codici di configurazione del sito

1 operazione con i suoi parametri, il modello di richiesta e le risposte.

Associazione e sessioni del lettore

12 operazioni con i relativi parametri, modelli di richiesta e risposte.

Manifest runtime, report ed eventi

24 operazioni con i relativi parametri, modelli di richiesta e risposte.

K/V applicazione runtime

4 operazioni con i relativi parametri, modelli di richiesta e risposte.

Contenuti protetti e risorse di rilascio

8 operazioni con i relativi parametri, modelli di richiesta e risposte.

Persone e dashboard progetto

94 operazioni con i relativi parametri, modelli di richiesta e risposte.

Ciclo di vita API, deprecazioni e limiti di velocità

Le famiglie di URL sono /api, /screen, /stream, /media, /website, /agentid. Modifiche compatibili all’interno di una major:

  • Endpoint e metodi additivi.
  • Membri opzionali della richiesta.
  • Nuovi codici problema.
  • Nuovi campi solo dove lo schema pubblicato permette campi sconosciuti.
  • Rimuovere un’operazione che risponde solo con errore, o che nessun client chiama.
  • Rimozione di un campo di risposta che nessun client utilizza.

Queste modifiche richiedono una nuova major:

  • Rimozione o rinomina di una rotta o campo funzionante chiamato dai client.
  • Modifiche a tipo, significato o autorizzazione.
  • Rendere obbligatorio un input opzionale.
  • Aggiunta di un membro a un enum chiuso.
  • Aggiunta di un campo a un oggetto risposta chiuso.

Un nuovo major si sovrappone per almeno 180 giorni. L’avviso di dismissione è di almeno 90 giorni, e un’operazione deprecata resta servita per almeno 90 giorni dalla data di efficacia della Deprecation RFC 9745 a meno che un impegno pubblicato successivamente non la controlli.

Nessuna operazione è attualmente deprecata.

I segnali del ciclo di vita sono:

  • OpenAPI deprecated true sull’operazione.
  • Deprecazione RFC 9745 con la sua data di efficacia.
  • Tramonto RFC 8594 una volta fissata la data di tramonto.
  • Collegamento con rel=deprecation alla documentazione di migrazione.

Campi limite di frequenza

Le operazioni con controlli a finestra fissa dichiarati indicano x-rate-limit-policies. Le risposte ammesse idonee possono includere i membri opzionali della lista di campi strutturati RateLimit-Policy e RateLimit. Le riproduzioni esatte e i deployment senza ammissione condivisa possono ometterli. I rifiuti a finestra fissa li includono; i rifiuti per concorrenza e budget di byte possono ometterli. Questi campi seguono draft-ietf-httpapi-ratelimit-headers-11, un Internet-Draft e non un RFC. Ad ogni 429, Retry-After è autorevole.

Problemi RFC 9457

Gli errori usano application/problem+json. Diramare su status e stabile code; trattare detail come spiegazione. Generato da problems.yaml.

project_required

400 · Seleziona un progetto

tipo: https://screenrig.ai/problems/project-required
free_organization_limit

409 · Limite gratuito dell’organizzazione raggiunto

tipo: https://screenrig.ai/problems/free-organization-limit
organization_plan_required

409 · L’organizzazione necessita di un piano prima di ammettere schermi

tipo: https://screenrig.ai/problems/organization-plan-required
project_name_conflict

409 · Nome progetto già usato nell’organizzazione

tipo: https://screenrig.ai/problems/project-name-conflict
project_delete_blocked

409 · Il progetto non può essere eliminato nello stato attuale

tipo: https://screenrig.ai/problems/project-delete-blocked
owner_required

409 · È richiesta una persona responsabile

tipo: https://screenrig.ai/problems/owner-required
owner_cannot_leave

409 · Il proprietario del progetto non può uscire

tipo: https://screenrig.ai/problems/owner-cannot-leave
internal_error

500 · Errore interno del server

tipo: https://screenrig.ai/problems/internal-error
invalid_request

400 · La richiesta non è valida

tipo: https://screenrig.ai/problems/invalid-request
unauthorized

401 · Autenticazione richiesta

tipo: https://screenrig.ai/problems/unauthorized
credential_retired

401 · La credenziale è stata ritirata

tipo: https://screenrig.ai/problems/credential-retired
client_update_required

410 · Aggiornare il plugin o CLI di screenRIG

tipo: https://screenrig.ai/problems/client-update-required
forbidden

403 · La richiesta non è consentita

tipo: https://screenrig.ai/problems/forbidden
insufficient_access

403 · Questo livello di accesso non può farlo

tipo: https://screenrig.ai/problems/insufficient-access
outside_upload_scope

403 · Fuori dalle playlist e dalle cartelle di questo uploader

tipo: https://screenrig.ai/problems/outside-upload-scope
outside_screen_scope

403 · Fuori dagli schermi di questo membro

tipo: https://screenrig.ai/problems/outside-screen-scope
protected_target

409 · Uno schermo protetto non si modifica in questo modo

tipo: https://screenrig.ai/problems/protected-target
second_approver_required

403 · Questa revisione deve essere decisa da un secondo approvatore

tipo: https://screenrig.ai/problems/second-approver-required
reserved_item

403 · Questa campagna è riservata

tipo: https://screenrig.ai/problems/reserved-item
approver_required

403 · Solo un approvatore può farlo

tipo: https://screenrig.ai/problems/approver-required
review_not_pending

409 · La revisione non è più in sospeso

tipo: https://screenrig.ai/problems/review-not-pending
review_stale

409 · L’oggetto è cambiato dopo questa proposta

tipo: https://screenrig.ai/problems/review-stale
review_blocked

409 · Un’altra revisione deve essere decisa prima

tipo: https://screenrig.ai/problems/review-blocked
playlist_not_approved

409 · La playlist non ha una versione approvata

tipo: https://screenrig.ai/problems/playlist-not-approved
media_pending_review

409 · Il contenuto multimediale è in attesa di revisione da parte di una persona

tipo: https://screenrig.ai/problems/media-pending-review
media_sync_source_refused

409 · L’origine della sincronizzazione media ha rifiutato la richiesta

tipo: https://screenrig.ai/problems/media-sync-source-refused
media_sync_source_unavailable

500 · L’origine della sincronizzazione media non è raggiungibile

tipo: https://screenrig.ai/problems/media-sync-source-unavailable
canva_not_configured

409 · Canva non è configurato

tipo: https://screenrig.ai/problems/canva-not-configured
canva_reconnect_required

409 · L’account Canva deve essere collegato

tipo: https://screenrig.ai/problems/canva-reconnect-required
dropbox_not_configured

409 · Dropbox non è configurato

tipo: https://screenrig.ai/problems/dropbox-not-configured
dropbox_reconnect_required

409 · L’account Dropbox deve essere collegato

tipo: https://screenrig.ai/problems/dropbox-reconnect-required
google_drive_not_configured

409 · Google Drive non è configurato

tipo: https://screenrig.ai/problems/google-drive-not-configured
media_sync_sharer_not_member

403 · La cartella non è stata condivisa da un membro del progetto

tipo: https://screenrig.ai/problems/media-sync-sharer-not-member
not_found

404 · Risorsa non trovata

tipo: https://screenrig.ai/problems/not-found
method_not_allowed

405 · Metodo non consentito

tipo: https://screenrig.ai/problems/method-not-allowed
idempotency_mismatch

409 · La chiave di idempotenza non corrisponde alla richiesta originale

tipo: https://screenrig.ai/problems/idempotency-mismatch
credential_issuance_expired

410 · L’emissione delle credenziali è scaduta

tipo: https://screenrig.ai/problems/credential-issuance-expired
user_email_conflict

409 · L’indirizzo e-mail appartiene a un’altra persona

tipo: https://screenrig.ai/problems/user-email-conflict
provisioning_invalid

404 · Provisioning browser non valido

tipo: https://screenrig.ai/problems/provisioning-invalid
provisioning_expired

410 · La fornitura del browser è scaduta

tipo: https://screenrig.ai/problems/provisioning-expired
provisioning_consumed

409 · Provisioning browser consumato

tipo: https://screenrig.ai/problems/provisioning-consumed
provisioning_exchange_mismatch

409 · Scambio provisioning browser non corrispondente

tipo: https://screenrig.ai/problems/provisioning-exchange-mismatch
browser_already_paired

409 · Browser già associato

tipo: https://screenrig.ai/problems/browser-already-paired
handoff_code_invalid

404 · Codice di passaggio browser non valido

tipo: https://screenrig.ai/problems/handoff-code-invalid
handoff_code_expired

410 · Il codice di trasferimento del browser è scaduto

tipo: https://screenrig.ai/problems/handoff-code-expired
handoff_session_rate_limited

429 · Sessione di trasferimento del browser limitata

tipo: https://screenrig.ai/problems/handoff-session-rate-limited
handoff_session_conflict

409 · Conflitto sessione passaggio browser

tipo: https://screenrig.ai/problems/handoff-session-conflict
browser_link_not_claimed

409 · Link browser non reclamato

tipo: https://screenrig.ai/problems/browser-link-not-claimed
browser_link_project_mismatch

403 · Progetto link browser non corrispondente

tipo: https://screenrig.ai/problems/browser-link-project-mismatch
origin_not_allowed

403 · Origine non consentita

tipo: https://screenrig.ai/problems/origin-not-allowed
resource_conflict

409 · Stato della risorsa in conflitto con la richiesta

tipo: https://screenrig.ai/problems/resource-conflict
card_not_found

404 · Scheda non trovata

tipo: https://screenrig.ai/problems/card-not-found
card_invalid

400 · Il posizionamento della scheda non è valido

tipo: https://screenrig.ai/problems/card-invalid
card_layout_invalid

400 · Il layout della scheda non è valido

tipo: https://screenrig.ai/problems/card-layout-invalid
card_layout_conflict

400 · Le schede nella pagina dichiarano lo stesso posto

tipo: https://screenrig.ai/problems/card-layout-conflict
card_data_invalid

409 · Il documento dati della scheda non corrisponde a una scheda che lo legge

tipo: https://screenrig.ai/problems/card-data-invalid
source_limit_reached

409 · L’organizzazione ha raggiunto il massimo di origini dati

type: https://screenrig.ai/problems/source-limit-reached
source_target_unsupported

422 · L’origine dati non può alimentare questa scheda

type: https://screenrig.ai/problems/source-target-unsupported
source_target_taken

409 · Un’altra origine dati alimenta già questa scheda

type: https://screenrig.ai/problems/source-target-taken
source_busy

409 · È in corso una sincronizzazione dell’origine dati

type: https://screenrig.ai/problems/source-busy
source_has_no_rooms

409 · Questo tipo di origine dati non offre sale

type: https://screenrig.ai/problems/source-has-no-rooms
source_secret_required

400 · Un segreto dell’origine dati manca o non è più valido

type: https://screenrig.ai/problems/source-secret-required
source_test_failed

422 · L’anteprima dell’origine dati non è riuscita

type: https://screenrig.ai/problems/source-test-failed
connection_app_not_configured

409 · L’app di screenRIG non è configurata per questo provider

tipo: https://screenrig.ai/problems/connection-app-not-configured
connection_limit_reached

409 · L’organizzazione ha il massimo numero di connessioni

tipo: https://screenrig.ai/problems/connection-limit-reached
card_media_invalid

400 · Il riferimento ai media della scheda non indica un’immagine pronta

tipo: https://screenrig.ai/problems/card-media-invalid
revision_conflict

412 · La revisione della risorsa non corrisponde

tipo: https://screenrig.ai/problems/revision-conflict
invalid_range

416 · L’intervallo di byte richiesto non è soddisfacibile

tipo: https://screenrig.ai/problems/invalid-range
quota_exceeded

413 · La quota di contenuti del progetto è superata

tipo: https://screenrig.ai/problems/quota-exceeded
payment_required

402 · È richiesto credito d’uso

tipo: https://screenrig.ai/problems/payment-required
reseller_generation_limit

402 · Limite di generazione di immagini del reseller raggiunto

tipo: https://screenrig.ai/problems/reseller-generation-limit
feature_not_in_plan

402 · Questa funzione non è inclusa nel piano del progetto

tipo: https://screenrig.ai/problems/feature-not-in-plan
rate_limited

429 · Il tasso di richieste è troppo alto

tipo: https://screenrig.ai/problems/rate-limited
revocation_unavailable

500 · Stato di revoca delle credenziali non disponibile

tipo: https://screenrig.ai/problems/revocation-unavailable
dependency_unavailable

500 · Dipendenza richiesta non disponibile

tipo: https://screenrig.ai/problems/dependency-unavailable
dependency_timeout

500 · Dipendenza richiesta non ha risposto in tempo

tipo: https://screenrig.ai/problems/dependency-timeout
schema_incompatible

500 · Lo schema del database non è compatibile

tipo: https://screenrig.ai/problems/schema-incompatible
not_ready

500 · Servizio non pronto

tipo: https://screenrig.ai/problems/not-ready
server_draining

421 · Il servizio è in fase di svuotamento

tipo: https://screenrig.ai/problems/server-draining
manifest_degraded

500 · Proiezione del manifesto di runtime degradata

tipo: https://screenrig.ai/problems/manifest-degraded
screenshot_unavailable

409 · Lo screenshot non è disponibile

tipo: https://screenrig.ai/problems/screenshot-unavailable
identity_invalid

400 · La chiave pubblica del lettore non è valida

tipo: https://screenrig.ai/problems/identity-invalid
identity_conflict

409 · La chiave pubblica del lettore non corrisponde all’iscrizione

tipo: https://screenrig.ai/problems/identity-conflict
enrollment_bound

409 · La chiave pubblica del lettore è già associata a un progetto

tipo: https://screenrig.ai/problems/enrollment-bound
proof_invalid

401 · La prova d’identità del lettore non è valida

tipo: https://screenrig.ai/problems/proof-invalid
screen_archived

409 · Lo schermo è archiviato

tipo: https://screenrig.ai/problems/screen-archived
screen_archive_required

409 · Archivia lo schermo invece di eliminarlo o dissociarlo

tipo: https://screenrig.ai/problems/screen-archive-required
passkey_invalid

401 · La cerimonia passkey non è valida

tipo: https://screenrig.ai/problems/passkey-invalid
passkey_unknown

401 · Questa passkey non è più registrata

tipo: https://screenrig.ai/problems/passkey-unknown
passkeys_disabled

403 · Le passkey sono disabilitate su questo server

tipo: https://screenrig.ai/problems/passkeys-disabled
application_in_use

409 · Un manifest live fa ancora riferimento a una release dell’applicazione

tipo: https://screenrig.ai/problems/application-in-use
agent_connection_invalid

404 · Connessione agente non valida

tipo: https://screenrig.ai/problems/agent-connection-invalid
agent_connection_code_mismatch

400 · Il codice non corrisponde a questo accesso

tipo: https://screenrig.ai/problems/agent-connection-code-mismatch
agent_connection_expired

410 · La connessione dell’agente è scaduta

tipo: https://screenrig.ai/problems/agent-connection-expired
agent_connection_conflict

409 · Connessione agente già risolta

tipo: https://screenrig.ai/problems/agent-connection-conflict
agent_connection_not_approved

409 · Connessione agente non approvata

tipo: https://screenrig.ai/problems/agent-connection-not-approved
agent_limit_exceeded

409 · Limite agenti superato

tipo: https://screenrig.ai/problems/agent-limit-exceeded
agent_lockout_risk

409 · Disconnettere l’ultimo agente attivo rischia il blocco

tipo: https://screenrig.ai/problems/agent-lockout-risk
recovery_ambiguous

409 · L’identificatore del dispositivo è associato a più di uno schermo

tipo: https://screenrig.ai/problems/recovery-ambiguous
recovery_expired

410 · L’offerta di recupero dello schermo è scaduta

tipo: https://screenrig.ai/problems/recovery-expired
recovery_not_offered

404 · Nessun recupero schermo in sospeso

tipo: https://screenrig.ai/problems/recovery-not-offered
invitation_limit_reached

409 · L’organizzazione ha il massimo numero di inviti in sospeso

tipo: https://screenrig.ai/problems/invitation-limit-reached
organization_admin_limit

409 · Limite amministratori dell’organizzazione raggiunto

tipo: https://screenrig.ai/problems/organization-admin-limit
library_no_screens

409 · Un progetto con schermi non può essere la Libreria

tipo: https://screenrig.ai/problems/library-no-screens
guest_not_allowed

403 · L’organizzazione non ammette questa persona come ospite

tipo: https://screenrig.ai/problems/guest-not-allowed
managed_member

409 · Un provider di identità gestisce questa persona

tipo: https://screenrig.ai/problems/managed-member
organization_admin_member

409 · Questo membro è un amministratore dell’organizzazione

tipo: https://screenrig.ai/problems/organization-admin-member
member_owns_projects

409 · Questo membro possiede progetti nell’organizzazione

tipo: https://screenrig.ai/problems/member-owns-projects
managed_elsewhere

409 · Un’altra organizzazione gestisce questa persona

tipo: https://screenrig.ai/problems/managed-elsewhere
version_required

409 · La playlist richiede una versione API più recente

tipo: https://screenrig.ai/problems/version-required
price_change_pending

409 · Campagna in pausa fino all’accettazione di nuove tariffe

tipo: https://screenrig.ai/problems/price-change-pending
quote_stale

409 · Il preventivo pubblicitario è scaduto o non aggiornato

tipo: https://screenrig.ai/problems/quote-stale
insufficient_credits

402 · Crediti idonei insufficienti

tipo: https://screenrig.ai/problems/insufficient-credits
self_deal

409 · Un progetto non può acquistare pubblicità nella propria rete

tipo: https://screenrig.ai/problems/self-deal
goal_overbooked

409 · L’obiettivo è maggiore delle riproduzioni disponibili

tipo: https://screenrig.ai/problems/goal-overbooked
invitation_invalid

404 · Invito non valido

tipo: https://screenrig.ai/problems/invitation-invalid
invitation_expired

410 · L’invito è scaduto

tipo: https://screenrig.ai/problems/invitation-expired
invitation_consumed

409 · L’invito è già stato accettato

tipo: https://screenrig.ai/problems/invitation-consumed
invitation_email_mismatch

403 · L’invito appartiene a un indirizzo e-mail diverso

tipo: https://screenrig.ai/problems/invitation-email-mismatch
reauthentication_required

401 · È richiesta una prova di accesso recente

tipo: https://screenrig.ai/problems/reauthentication-required
member_limit_reached

409 · Il progetto ha il massimo numero di membri

tipo: https://screenrig.ai/problems/member-limit-reached
project_limit_reached

409 · L’organizzazione ha il massimo numero di progetti

type: https://screenrig.ai/problems/project-limit-reached
billed_by_reseller

409 · L’organizzazione è fatturata tramite il suo reseller

tipo: https://screenrig.ai/problems/billed-by-reseller
reseller_conflict

409 · L’organizzazione non può assumere quel ruolo di reseller

tipo: https://screenrig.ai/problems/reseller-conflict
last_credential

409 · L’ultimo metodo di accesso non può essere rimosso

tipo: https://screenrig.ai/problems/last-credential
sso_required

403 · Questo indirizzo accede tramite il suo provider di identità

tipo: https://screenrig.ai/problems/sso-required
no_project

409 · Nessun progetto corrente selezionato

tipo: https://screenrig.ai/problems/no-project
feature_unavailable

404 · Questa funzione non è disponibile su questo server

tipo: https://screenrig.ai/problems/feature-unavailable
user_binding_stale

409 · Il vincolo e-mail utente che reclama è scaduto

tipo: https://screenrig.ai/problems/user-binding-stale
session_expired

401 · La sessione runtime è scaduta o non è più attuale

tipo: https://screenrig.ai/problems/session-expired
credential_revoked

401 · La credenziale del dispositivo non associa più questo dispositivo a uno schermo

tipo: https://screenrig.ai/problems/credential-revoked
screen_link_invalid

401 · Il link dello schermo non è valido

tipo: https://screenrig.ai/problems/screen-link-invalid
screen_link_not_found

404 · Lo schermo non ha un link

tipo: https://screenrig.ai/problems/screen-link-not-found
proof_clock_skew

401 · La prova d’identità del lettore è fuori dalla finestra temporale accettata

tipo: https://screenrig.ai/problems/proof-clock-skew
key_retired

401 · La chiave del lettore è stata sostituita e il periodo di grazia è terminato

tipo: https://screenrig.ai/problems/key-retired
assignment_not_found

404 · Lo schermo non ha assegnazione di playlist

tipo: https://screenrig.ai/problems/assignment-not-found
upgrade_required

403 · La versione del lettore è inferiore al minimo supportato

tipo: https://screenrig.ai/problems/upgrade-required
reboot_unsupported

409 · Lo schermo non può riavviarsi da remoto

tipo: https://screenrig.ai/problems/reboot-unsupported
command_unsupported

409 · Lo schermo non può eseguire questa azione da remoto

tipo: https://screenrig.ai/problems/command-unsupported
play_page_unsupported

409 · Lo schermo non può riprodurre una pagina su richiesta

tipo: https://screenrig.ai/problems/play-page-unsupported
identify_unsupported

409 · Lo schermo non può identificarsi

tipo: https://screenrig.ai/problems/identify-unsupported
page_not_on_screen

409 · La pagina non è nella playlist che lo schermo sta riproducendo

tipo: https://screenrig.ai/problems/page-not-on-screen
live_unsupported

409 · Lo schermo non può mostrare la vista live

tipo: https://screenrig.ai/problems/live-unsupported
live_unavailable

409 · La vista live non è disponibile per questo schermo

tipo: https://screenrig.ai/problems/live-unavailable
live_not_ready

409 · Lo schermo non sta ancora pubblicando

tipo: https://screenrig.ai/problems/live-not-ready
live_session_ended

410 · La sessione live è terminata

tipo: https://screenrig.ai/problems/live-session-ended
wall_unsupported

409 · Lo schermo non può disporre un video wall

tipo: https://screenrig.ai/problems/wall-unsupported
playlist_format_mismatch

409 · Il formato della playlist non corrisponde al video wall dello schermo

tipo: https://screenrig.ai/problems/playlist-format-mismatch
primitive_locked

403 · Un elemento bloccato può essere modificato solo da chi può approvare

tipo: https://screenrig.ai/problems/primitive-locked
playlist_is_template

409 · La playlist è un modello

tipo: https://screenrig.ai/problems/playlist-is-template
webhook_limit_reached

409 · L’organizzazione ha raggiunto il numero massimo di webhook

tipo: https://screenrig.ai/problems/webhook-limit-reached
alert_not_open

409 · L’alert non è aperto

type: https://screenrig.ai/problems/alert-not-open
alert_mute_limit_reached

409 · L’organizzazione ha raggiunto il numero massimo di silenziamenti

type: https://screenrig.ai/problems/alert-mute-limit-reached
notification_limit_reached

409 · L’organizzazione ha raggiunto il numero massimo di notifiche

type: https://screenrig.ai/problems/notification-limit-reached
notification_covers_other_projects

409 · La notifica copre altri progetti

type: https://screenrig.ai/problems/notification-covers-other-projects
report_subscription_limit_reached

409 · L’organizzazione ha raggiunto il numero massimo di abbonamenti ai report

type: https://screenrig.ai/problems/report-subscription-limit-reached
fleet_link_limit_reached

409 · L’organizzazione ha il massimo numero di collegamenti alla flotta

tipo: https://screenrig.ai/problems/fleet-link-limit-reached
webhook_url_rejected

400 · L’URL del webhook deve essere HTTPS su un host pubblico Internet

tipo: https://screenrig.ai/problems/webhook-url-rejected
notification_destination_rejected

400 · La destinazione della notifica non è valida per il suo canale

tipo: https://screenrig.ai/problems/notification-destination-rejected
document_not_shared

400 · Il documento chiede agli spettatori di accedere

type: https://screenrig.ai/problems/document-not-shared
note_contains_credential

422 · Il testo della nota contiene una credenziale

tipo: https://screenrig.ai/problems/note-contains-credential
note_rejected

422 · Il testo della nota è stato rifiutato

tipo: https://screenrig.ai/problems/note-rejected
note_not_open

409 · La nota non è aperta

tipo: https://screenrig.ai/problems/note-not-open
note_limit_reached

409 · L’organizzazione ha il massimo numero di note aperte

tipo: https://screenrig.ai/problems/note-limit-reached
trigger_limit_reached

409 · L’organizzazione ha il massimo numero di trigger

tipo: https://screenrig.ai/problems/trigger-limit-reached
bi_upstream_refused

409 · Il sistema BI ha rifiutato la connessione

tipo: https://screenrig.ai/problems/bi-upstream-refused
bi_upstream_unavailable

500 · Il sistema BI non è raggiungibile

tipo: https://screenrig.ai/problems/bi-upstream-unavailable
bi_web_unavailable

409 · Questo server non ha un renderer di pagine

tipo: https://screenrig.ai/problems/bi-web-unavailable
schedule_import_invalid

422 · L’importazione contiene righe con errori

type: https://screenrig.ai/problems/schedule-import-invalid
schedule_import_stale

409 · Il progetto è cambiato dopo l’anteprima

type: https://screenrig.ai/problems/schedule-import-stale
campaign_limit_reached

409 · L’organizzazione ha il massimo di campagne

tipo: https://screenrig.ai/problems/campaign-limit-reached
kv_webhook_limit_reached

409 · L’applicazione ha il massimo numero di webhook chiave/valore

tipo: https://screenrig.ai/problems/kv-webhook-limit-reached
support_conversation_closed

409 · La conversazione di assistenza è chiusa

tipo: https://screenrig.ai/problems/support-conversation-closed
submission_too_short

422 · L’invio è troppo breve per agire

tipo: https://screenrig.ai/problems/submission-too-short
submission_unclear

422 · L’invio non descrive un problema o una richiesta

tipo: https://screenrig.ai/problems/submission-unclear
submission_rejected

422 · L’invio non è stato accettato

tipo: https://screenrig.ai/problems/submission-rejected
submission_screening_unavailable

500 · Invio non può essere visualizzato ora

tipo: https://screenrig.ai/problems/submission-screening-unavailable
demo_slot_unavailable

409 · Il tempo della demo non è più disponibile

tipo: https://screenrig.ai/problems/demo-slot-unavailable
agentid_claim_invalid

400 · La richiesta AgentID non è valida o è scaduta

tipo: https://screenrig.ai/problems/agentid-claim-invalid
agentid_already_enrolled

409 · AgentID già registrato

tipo: https://screenrig.ai/problems/agentid-already-enrolled
account_exists

409 · Questa email ha già un account screenRIG

tipo: https://screenrig.ai/problems/account-exists
email_verification_required

403 · Verifica la tua email per continuare

tipo: https://screenrig.ai/problems/email-verification-required
unverified_account_replacement

409 · Questo reset crea un nuovo account vuoto

tipo: https://screenrig.ai/problems/unverified-account-replacement
app_store_transaction_invalid

422 · Impossibile verificare l’acquisto su App Store

tipo: https://screenrig.ai/problems/app-store-transaction-invalid
app_store_account_mismatch

409 · L’acquisto appartiene a un’altra organizzazione

tipo: https://screenrig.ai/problems/app-store-account-mismatch
education_not_eligible

403 · L’organizzazione non è idonea al piano Education

tipo: https://screenrig.ai/problems/education-not-eligible
app_store_plan_conflict

409 · L’organizzazione ha già un piano

tipo: https://screenrig.ai/problems/app-store-plan-conflict

Diagnostica e origine contratto

La diagnostica CLI inclusa mantiene fuori dall’output conservato autorizzazioni, cookie, dettagli di caricamento firmati, identificatori di oggetti e contenuti cliente. Il documento OpenAPI grezzo è la fonte di verità HTTP.

Indice schema

Nomi generati, campi obbligatori e descrizioni dello schema; usa OpenAPI grezzo per lo schema JSON completo.