Riferimento API

API Servizio e capacità

Metadati del servizio, capacità e ricerca nella documentazione

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

Questo gruppo ha 6 operazioni, generate da api/openapi.yaml. Filtra per percorso, azione o autenticazione. Ogni endpoint elenca i suoi input; espandilo per vedere un modello di richiesta e i codici di risposta. I modelli richiedono i tuoi valori e un corpo valido secondo lo schema.

Sostituisci i segnaposto maiuscoli con i tuoi valori. Per una richiesta JSON, salva un corpo che corrisponde allo schema in request.json. Gli esempi di cookie usano un cookie jar locale da una sessione autenticata.

Metadati del servizio, capacità e ricerca nella documentazione

GET/.health

Ottieni Health

Autenticazione
nessuno
Corpo della richiesta
nessuno
ID operazione
getHealth
Modello richiesta e risposte
shell · modello richiesta
curl --request GET 'https://api.screenrig.ai/.health'

Risposte

StatoSignificatoCorpo e intestazioni
200AttivoHealthResponse (application/json)
GET/.ready

Ottieni prontezza

Pronto per il servizio. Un host in fase di svuotamento risponde con 421 server_draining e Retry-After: 1. Un guasto a una dipendenza richiesta risponde con 500 not_ready e Retry-After. Uno schema di database attivo che non soddisfa questa versione (un indice desiderato mancante o diverso da più di due minuti) risponde con 500 schema_incompatible senza Retry-After: non si risolve aspettando.

Autenticazione
nessuno
Corpo della richiesta
nessuno
ID operazione
getReadiness
Modello richiesta e risposte
shell · modello richiesta
curl --request GET 'https://api.screenrig.ai/.ready'

Risposte

StatoSignificatoCorpo e intestazioni
200ProntoReadyResponse (application/json)
421

Risposta problema stabile RFC 9457 su runtime, contenuto o percorso probe rivolto al Player, nella forma documento runtime (RuntimeProblem). Un 421 server_draining ha Retry-After di 1 secondo, un 500 not_ready o dependency_unavailable ha 5, e un 500 manifest_degraded ha 60, salvo valore più specifico impostato dal gestore.

RuntimeProblem (application/problem+json)
500

Risposta problema stabile RFC 9457 su runtime, contenuto o percorso probe rivolto al Player, nella forma documento runtime (RuntimeProblem). Un 421 server_draining ha Retry-After di 1 secondo, un 500 not_ready o dependency_unavailable ha 5, e un 500 manifest_degraded ha 60, salvo valore più specifico impostato dal gestore.

RuntimeProblem (application/problem+json)
GET/.version

Ottieni versione

Autenticazione
nessuno
Corpo della richiesta
nessuno
ID operazione
getVersion
Modello richiesta e risposte
shell · modello richiesta
curl --request GET 'https://api.screenrig.ai/.version'

Risposte

StatoSignificatoCorpo e intestazioni
200VersioneVersionResponse (application/json)
GET/api/capabilities

Ottieni capacità

Autenticazione
nessuno
Corpo della richiesta
nessuno
ID operazione
getCapabilities
Modello richiesta e risposte
shell · modello richiesta
curl --request GET 'https://api.screenrig.ai/api/capabilities'

Risposte

StatoSignificatoCorpo e intestazioni
200Limiti di capacità e archivioCapacità (application/json)
GET/api/docs/search

Cerca nella documentazione ufficiale

Cerca nella documentazione ufficiale di screenRIG, nelle pagine di screenrig.ai/docs, nei tipi di problema, nei prezzi e nelle altre pagine per i clienti, e restituisce le sezioni più pertinenti, le migliori per prime, al massimo limit (8 per impostazione predefinita). Pubblico: non serve alcuna credenziale e la chiamata non viene mai addebitata.

L’url di un risultato è la sua pagina (con il frammento della sezione dove la pagina ne indica uno), section è il titolo e snippet mostra il testo attorno alla corrispondenza; leggi la pagina o la sezione con getDocsPage. Limitato a 120 richieste per IP client al minuto (IPv6 raggruppati per /64).

Il corpus si ricarica ogni 15 minuti; prima del primo caricamento la rotta risponde 500 not_ready con Retry-After.

Autenticazione
nessuno
Corpo della richiesta
nessuno
ID operazione
searchDocs

Parametri

NomeInviaObbligatorio?Descrizione
qqueryobbligatorioParole, un comando o un’opzione, o un codice di errore, da 1 a 200 caratteri.
limitequeryopzionale
Modello richiesta e risposte
shell · modello richiesta
curl --request GET 'https://api.screenrig.ai/api/docs/search?q=Q'

Risposte

StatoSignificatoCorpo e intestazioni
200Le sezioni corrispondenti, le migliori per prime. Vuoto quando nulla corrisponde.DocsSearchResponse (application/json); intestazioni: RateLimit-Policy, RateLimit
predefinito

Risposta problema stabile RFC 9457. Un 421 server_draining ha Retry-After di 1 secondo, un 500 not_ready o dependency_unavailable ha 5, e un 500 manifest_degraded ha 60, salvo valore più specifico impostato dal gestore.

Problema (application/problem+json)
429

Problema rate_limited stabile. Ritenta solo dopo l'intervallo Retry-After autorevole. I dinieghi a finestra fissa includono anche RateLimit-Policy e membri RateLimit applicabili; i dinieghi per concorrenza e budget byte omettono tali divulgazioni opzionali.

Problema (application/problem+json); intestazioni: Retry-After, RateLimit-Policy, RateLimit
GET/api/docs/page

Leggi una pagina o una sezione della documentazione ufficiale

Restituisce una pagina della documentazione ufficiale o, con section, una sola sua sezione con le sezioni al suo interno, come Markdown. url è l’indirizzo della pagina come lo restituisce searchDocs, la sua forma .md, oppure solo il suo percorso, con o senza #fragment (un frammento indica la sezione quando section non è indicato). section è un titolo o un’ancora della pagina, o parte di un titolo.

Una sezione viene tagliata a fine riga entro 48 KiB, con truncated true; una pagina intera di oltre 48 KiB risponde con la sua introduzione e la sua struttura, con truncated true. sections elenca i titoli da leggere dopo (quelli della pagina, o i sottotitoli della sezione stessa). Le pagine e le sezioni sconosciute rispondono 404 not_found.

Pubblico, mai addebitato e limitato alle stesse 120 richieste per IP client al minuto di searchDocs.

Autenticazione
nessuno
Corpo della richiesta
nessuno
ID operazione
getDocsPage

Parametri

NomeInviaObbligatorio?Descrizione
urlqueryobbligatorioL’indirizzo della pagina, da 1 a 500 caratteri.
sectionqueryopzionaleUn titolo o un’ancora della pagina, al massimo 200 caratteri.
Modello richiesta e risposte
shell · modello richiesta
curl --request GET 'https://api.screenrig.ai/api/docs/page?url=URL'

Risposte

StatoSignificatoCorpo e intestazioni
200La pagina o la sezione come Markdown.DocsPage (application/json); intestazioni: RateLimit-Policy, RateLimit
predefinito

Risposta problema stabile RFC 9457. Un 421 server_draining ha Retry-After di 1 secondo, un 500 not_ready o dependency_unavailable ha 5, e un 500 manifest_degraded ha 60, salvo valore più specifico impostato dal gestore.

Problema (application/problem+json)
429

Problema rate_limited stabile. Ritenta solo dopo l'intervallo Retry-After autorevole. I dinieghi a finestra fissa includono anche RateLimit-Policy e membri RateLimit applicabili; i dinieghi per concorrenza e budget byte omettono tali divulgazioni opzionali.

Problema (application/problem+json); intestazioni: Retry-After, RateLimit-Policy, RateLimit