OpenAPI YAMLOpenAPI JSONproblèmes YAMLVue d’ensemble de l’API
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
Obtenir Health
Modèle de requête et réponses
curl --request GET 'https://api.screenrig.ai/.health'Réponses
| Statut | Sens | Corps et en-têtes |
|---|---|---|
| 200 | En vie | HealthResponse (application/json) |
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.
Modèle de requête et réponses
curl --request GET 'https://api.screenrig.ai/.ready'Réponses
| Statut | Sens | Corps et en-têtes |
|---|---|---|
| 200 | Prêt | ReadyResponse (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) |
Obtenir la version
Modèle de requête et réponses
curl --request GET 'https://api.screenrig.ai/.version'Réponses
| Statut | Sens | Corps et en-têtes |
|---|---|---|
| 200 | Version | VersionResponse (application/json) |
Obtenir les capacités
Modèle de requête et réponses
curl --request GET 'https://api.screenrig.ai/api/capabilities'Réponses
| Statut | Sens | Corps et en-têtes |
|---|---|---|
| 200 | Limites de capacité et d’archive | Capacités (application/json) |
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.
Paramètres
| Nom | Envoyer | Requis ? | Description |
|---|---|---|---|
| q | requête | obligatoire | Des mots, une commande ou une option, ou un code d’erreur, 1 à 200 caractères. |
| limite | requête | optionnel |
Modèle de requête et réponses
curl --request GET 'https://api.screenrig.ai/api/docs/search?q=Q'Réponses
| Statut | Sens | Corps et en-têtes |
|---|---|---|
| 200 | Les 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 |
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.
Paramètres
| Nom | Envoyer | Requis ? | Description |
|---|---|---|---|
| url | requête | obligatoire | L’adresse de la page, 1 à 500 caractères. |
| section | requête | optionnel | Un titre ou une ancre de la page, 200 caractères au plus. |
Modèle de requête et réponses
curl --request GET 'https://api.screenrig.ai/api/docs/page?url=URL'Réponses
| Statut | Sens | Corps et en-têtes |
|---|---|---|
| 200 | La 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 |