Référence API

API Service et capacités

Métadonnées du service, capacités et recherche dans la documentation

Référence HTTP. Générée à partir du contrat backend. Parcourez les points de terminaison ci-dessous ou téléchargez OpenAPI.

Ce groupe compte 6 opérations, générées à partir de api/openapi.yaml. Filtrez par chemin, action ou authentification. Chaque point de terminaison liste ses entrées ; développez-le pour voir un modèle de requête et les codes de réponse. Les modèles demandent vos propres valeurs et un corps conforme au schéma.

Remplacez les espaces réservés en majuscules par vos valeurs. Pour une requête JSON, enregistrez un corps correspondant au schéma dans request.json. Les exemples de cookies utilisent un pot à cookies local issu d’une session authentifiée.

Métadonnées du service, capacités et recherche dans la documentation

GET/.health

Obtenir Health

Authentification
aucun
Corps de la requête
aucun
ID d’opération
getHealth
Modèle de requête et réponses
shell · modèle de requête
curl --request GET 'https://api.screenrig.ai/.health'

Réponses

StatutSensCorps et en-têtes
200En vieHealthResponse (application/json)
GET/.ready

Obtenir la préparation

Prêt à servir. Un hôte en vidange répond 421 server_draining avec Retry-After : 1. Une défaillance d’une dépendance requise répond 500 not_ready avec Retry-After. Un schéma de base de données actif qui ne satisfait pas cette version (un index désiré manquant ou différent depuis plus de deux minutes) répond 500 schema_incompatible sans Retry-After : cela ne se résout pas en attendant.

Authentification
aucun
Corps de la requête
aucun
ID d’opération
getReadiness
Modèle de requête et réponses
shell · modèle de requête
curl --request GET 'https://api.screenrig.ai/.ready'

Réponses

StatutSensCorps et en-têtes
200PrêtReadyResponse (application/json)
421

Réponse stable RFC 9457 à un problème sur un runtime, contenu ou route de sonde face au lecteur, dans la forme du document runtime (RuntimeProblem). Un 421 server_draining porte un Retry-After de 1 seconde, un 500 not_ready ou dependency_unavailable porte 5, et un 500 manifest_degraded porte 60, sauf si le gestionnaire a défini une valeur plus spécifique.

Problème Runtime (application/problem+json)
500

Réponse stable RFC 9457 à un problème sur un runtime, contenu ou route de sonde face au lecteur, dans la forme du document runtime (RuntimeProblem). Un 421 server_draining porte un Retry-After de 1 seconde, un 500 not_ready ou dependency_unavailable porte 5, et un 500 manifest_degraded porte 60, sauf si le gestionnaire a défini une valeur plus spécifique.

Problème Runtime (application/problem+json)
GET/.version

Obtenir la version

Authentification
aucun
Corps de la requête
aucun
ID d’opération
getVersion
Modèle de requête et réponses
shell · modèle de requête
curl --request GET 'https://api.screenrig.ai/.version'

Réponses

StatutSensCorps et en-têtes
200VersionVersionResponse (application/json)
GET/api/capabilities

Obtenir les capacités

Authentification
aucun
Corps de la requête
aucun
ID d’opération
getCapabilities
Modèle de requête et réponses
shell · modèle de requête
curl --request GET 'https://api.screenrig.ai/api/capabilities'

Réponses

StatutSensCorps et en-têtes
200Limites de capacité et d’archiveCapacités (application/json)
GET/api/docs/search

Rechercher dans la documentation officielle

Recherche dans la documentation officielle de screenRIG, les pages de screenrig.ai/docs, les types de problèmes, les tarifs et les autres pages destinées aux clients, et renvoie les sections les plus pertinentes, la meilleure d’abord, au plus limit (8 par défaut). Public : aucun identifiant n’est requis et l’appel n’est jamais facturé.

L’url d’un résultat est sa page (avec le fragment de la section lorsque la page en nomme un), section est le titre et snippet montre le texte autour de la correspondance ; lisez la page ou la section avec getDocsPage. Limité à 120 requêtes par IP cliente et par minute (IPv6 regroupées par /64).

Le corpus est rechargé toutes les 15 minutes ; avant le premier chargement, la route répond 500 not_ready avec Retry-After.

Authentification
aucun
Corps de la requête
aucun
ID d’opération
searchDocs

Paramètres

NomEnvoyerRequis ?Description
qrequêteobligatoireDes mots, une commande ou une option, ou un code d’erreur, 1 à 200 caractères.
limiterequêteoptionnel
Modèle de requête et réponses
shell · modèle de requête
curl --request GET 'https://api.screenrig.ai/api/docs/search?q=Q'

Réponses

StatutSensCorps et en-têtes
200Les sections correspondantes, la meilleure d’abord. Vide lorsque rien ne correspond.DocsSearchResponse (application/json) ; en-têtes : RateLimit-Policy, RateLimit
par défaut

Réponse stable RFC 9457 à un problème. Un 421 server_draining porte un Retry-After de 1 seconde, un 500 not_ready ou dependency_unavailable porte 5, et un 500 manifest_degraded porte 60, sauf si le gestionnaire a défini une valeur plus spécifique.

Problème (application/problem+json)
429

Problème stable rate_limited. Réessayez seulement après l’intervalle Retry-After autoritaire. Les refus à fenêtre fixe incluent aussi la politique RateLimit-Policy applicable et les membres RateLimit ; les refus de concurrence et de budget d’octets omettent ces divulgations optionnelles.

Problème (application/problem+json) ; en-têtes : Retry-After, RateLimit-Policy, RateLimit
GET/api/docs/page

Lire une page ou une section de la documentation officielle

Renvoie une page de la documentation officielle ou, avec section, une seule de ses sections avec ses sous-sections, en Markdown. url est l’adresse de la page telle que la renvoie searchDocs, sa forme .md, ou seulement son chemin, avec ou sans #fragment (un fragment nomme la section lorsque section n’est pas fourni). section est un titre ou une ancre de la page, ou une partie d’un titre.

Une section est coupée à une fin de ligne dans la limite de 48 KiB, avec truncated true ; une page entière de plus de 48 KiB répond par son introduction et son plan, avec truncated true. sections liste les titres à lire ensuite (ceux de la page, ou les sous-titres de la section elle-même). Les pages et sections inconnues répondent 404 not_found.

Public, jamais facturé, et limité aux mêmes 120 requêtes par IP cliente et par minute que searchDocs.

Authentification
aucun
Corps de la requête
aucun
ID d’opération
getDocsPage

Paramètres

NomEnvoyerRequis ?Description
urlrequêteobligatoireL’adresse de la page, 1 à 500 caractères.
sectionrequêteoptionnelUn titre ou une ancre de la page, 200 caractères au plus.
Modèle de requête et réponses
shell · modèle de requête
curl --request GET 'https://api.screenrig.ai/api/docs/page?url=URL'

Réponses

StatutSensCorps et en-têtes
200La page ou la section en Markdown.DocsPage (application/json) ; en-têtes : RateLimit-Policy, RateLimit
par défaut

Réponse stable RFC 9457 à un problème. Un 421 server_draining porte un Retry-After de 1 seconde, un 500 not_ready ou dependency_unavailable porte 5, et un 500 manifest_degraded porte 60, sauf si le gestionnaire a défini une valeur plus spécifique.

Problème (application/problem+json)
429

Problème stable rate_limited. Réessayez seulement après l’intervalle Retry-After autoritaire. Les refus à fenêtre fixe incluent aussi la politique RateLimit-Policy applicable et les membres RateLimit ; les refus de concurrence et de budget d’octets omettent ces divulgations optionnelles.

Problème (application/problem+json) ; en-têtes : Retry-After, RateLimit-Policy, RateLimit