OpenAPI YAMLOpenAPI JSONproblemi YAMLPanoramica dell’API
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
Ottieni Health
Modello richiesta e risposte
curl --request GET 'https://api.screenrig.ai/.health'Risposte
| Stato | Significato | Corpo e intestazioni |
|---|---|---|
| 200 | Attivo | HealthResponse (application/json) |
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.
Modello richiesta e risposte
curl --request GET 'https://api.screenrig.ai/.ready'Risposte
| Stato | Significato | Corpo e intestazioni |
|---|---|---|
| 200 | Pronto | ReadyResponse (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) |
Ottieni versione
Modello richiesta e risposte
curl --request GET 'https://api.screenrig.ai/.version'Risposte
| Stato | Significato | Corpo e intestazioni |
|---|---|---|
| 200 | Versione | VersionResponse (application/json) |
Ottieni capacità
Modello richiesta e risposte
curl --request GET 'https://api.screenrig.ai/api/capabilities'Risposte
| Stato | Significato | Corpo e intestazioni |
|---|---|---|
| 200 | Limiti di capacità e archivio | Capacità (application/json) |
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.
Parametri
| Nome | Invia | Obbligatorio? | Descrizione |
|---|---|---|---|
| q | query | obbligatorio | Parole, un comando o un’opzione, o un codice di errore, da 1 a 200 caratteri. |
| limite | query | opzionale |
Modello richiesta e risposte
curl --request GET 'https://api.screenrig.ai/api/docs/search?q=Q'Risposte
| Stato | Significato | Corpo e intestazioni |
|---|---|---|
| 200 | Le 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 |
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.
Parametri
| Nome | Invia | Obbligatorio? | Descrizione |
|---|---|---|---|
| url | query | obbligatorio | L’indirizzo della pagina, da 1 a 500 caratteri. |
| section | query | opzionale | Un titolo o un’ancora della pagina, al massimo 200 caratteri. |
Modello richiesta e risposte
curl --request GET 'https://api.screenrig.ai/api/docs/page?url=URL'Risposte
| Stato | Significato | Corpo e intestazioni |
|---|---|---|
| 200 | La 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 |