OpenAPI YAMLOpenAPI JSONproblemas YAMLResumen de la API
Este grupo tiene 6 operaciones, generadas a partir de api/openapi.yaml. Filtre por ruta, acción o autenticación. Cada endpoint indica sus entradas; despliéguelo para ver una plantilla de solicitud y los códigos de respuesta. Las plantillas necesitan sus propios valores y un cuerpo válido según el esquema.
Reemplace los marcadores en mayúsculas con sus valores. Para una solicitud JSON, guarde un cuerpo que coincida con el esquema en request.json. Los ejemplos de cookies usan un frasco de cookies local de una sesión autenticada.
Metadatos del servicio, capacidades y búsqueda en la documentación
Obtener Health
Plantilla y respuestas de solicitud
curl --request GET 'https://api.screenrig.ai/.health'Respuestas
| Estado | Significado | Cuerpo y encabezados |
|---|---|---|
| 200 | Activo | HealthResponse (application/json) |
Obtener preparación
Preparación para servir. Un host en drenaje responde 421 server_draining con Retry-After: 1. Una falla de dependencia requerida responde 500 not_ready con Retry-After. Un esquema de base de datos activo que no satisface esta versión (un índice deseado ausente o diferente por más de dos minutos) responde 500 schema_incompatible sin Retry-After: no se resuelve esperando.
Plantilla y respuestas de solicitud
curl --request GET 'https://api.screenrig.ai/.ready'Respuestas
| Estado | Significado | Cuerpo y encabezados |
|---|---|---|
| 200 | Listo | ReadyResponse (application/json) |
| 421 | Respuesta estable RFC 9457 a problemas en una ruta de ejecución, contenido o sonda orientada al reproductor, en la forma del documento de ejecución (RuntimeProblem). Un 421 server_draining lleva Retry-After de 1 segundo, un 500 not_ready o dependency_unavailable lleva 5, y un 500 manifest_degraded lleva 60, a menos que el manejador establezca un valor más específico. | RuntimeProblem (application/problem+json) |
| 500 | Respuesta estable RFC 9457 a problemas en una ruta de ejecución, contenido o sonda orientada al reproductor, en la forma del documento de ejecución (RuntimeProblem). Un 421 server_draining lleva Retry-After de 1 segundo, un 500 not_ready o dependency_unavailable lleva 5, y un 500 manifest_degraded lleva 60, a menos que el manejador establezca un valor más específico. | RuntimeProblem (application/problem+json) |
Obtener versión
Plantilla y respuestas de solicitud
curl --request GET 'https://api.screenrig.ai/.version'Respuestas
| Estado | Significado | Cuerpo y encabezados |
|---|---|---|
| 200 | Versión | RespuestaDeVersión (application/json) |
Obtener capacidades
Plantilla y respuestas de solicitud
curl --request GET 'https://api.screenrig.ai/api/capabilities'Respuestas
| Estado | Significado | Cuerpo y encabezados |
|---|---|---|
| 200 | Límites de capacidad y archivo | Capacidades (application/json) |
Buscar en la documentación oficial
Busca en la documentación oficial de screenRIG, las páginas de screenrig.ai/docs, los tipos de problemas, los precios y las demás páginas para clientes, y devuelve las secciones que mejor coinciden, la mejor primero, como máximo limit (8 por defecto). Público: no se necesita ninguna credencial y la llamada nunca se cobra.
La url de un resultado es su página (con el fragmento de la sección cuando la página nombra uno), section es el encabezado y snippet muestra el texto alrededor de la coincidencia; lea la página o la sección con getDocsPage. Limitado a 120 solicitudes por IP de cliente y minuto (IPv6 agrupadas por /64).
El corpus se recarga cada 15 minutos; antes de la primera carga, la ruta responde 500 not_ready con Retry-After.
Parámetros
| Nombre | Enviar | ¿Requerido? | Descripción |
|---|---|---|---|
| q | consulta | requerido | Palabras, un comando u opción, o un código de error, de 1 a 200 caracteres. |
| límite | consulta | opcional |
Plantilla y respuestas de solicitud
curl --request GET 'https://api.screenrig.ai/api/docs/search?q=Q'Respuestas
| Estado | Significado | Cuerpo y encabezados |
|---|---|---|
| 200 | Las secciones coincidentes, la mejor primero. Vacío cuando nada coincide. | DocsSearchResponse (application/json); encabezados: RateLimit-Policy, RateLimit |
| predeterminado | Respuesta estable RFC 9457 a problemas. Un 421 server_draining lleva Retry-After de 1 segundo, un 500 not_ready o dependency_unavailable lleva 5, y un 500 manifest_degraded lleva 60, a menos que el manejador establezca un valor más específico. | Problema (application/problem+json) |
| 429 | Problema estable rate_limited. Reintente solo después del intervalo Retry-After autorizado. Las denegaciones de ventana fija también incluyen la política RateLimit-Policy y los miembros RateLimit aplicables; las denegaciones por concurrencia y presupuesto de bytes omiten esas divulgaciones opcionales. | Problema (application/problem+json); encabezados: Retry-After, RateLimit-Policy, RateLimit |
Leer una página o sección de la documentación oficial
Devuelve una página de la documentación oficial o, con section, una sola de sus secciones con las secciones que contiene, en Markdown. url es la dirección de la página tal como la devuelve searchDocs, su forma .md o solo su ruta, con o sin #fragment (un fragmento nombra la sección cuando no se indica section). section es un encabezado o un ancla de la página, o parte de un encabezado.
Una sección se corta en un final de línea dentro de 48 KiB, con truncated true; una página completa de más de 48 KiB responde con su introducción y su esquema, con truncated true. sections lista los encabezados que leer a continuación (los de la página o los subencabezados de la propia sección). Las páginas y secciones desconocidas responden 404 not_found.
Público, nunca se cobra y está limitado a las mismas 120 solicitudes por IP de cliente y minuto que searchDocs.
Parámetros
| Nombre | Enviar | ¿Requerido? | Descripción |
|---|---|---|---|
| url | consulta | requerido | La dirección de la página, de 1 a 500 caracteres. |
| section | consulta | opcional | Un encabezado o ancla de la página, como máximo 200 caracteres. |
Plantilla y respuestas de solicitud
curl --request GET 'https://api.screenrig.ai/api/docs/page?url=URL'Respuestas
| Estado | Significado | Cuerpo y encabezados |
|---|---|---|
| 200 | La página o sección como Markdown. | DocsPage (application/json); encabezados: RateLimit-Policy, RateLimit |
| predeterminado | Respuesta estable RFC 9457 a problemas. Un 421 server_draining lleva Retry-After de 1 segundo, un 500 not_ready o dependency_unavailable lleva 5, y un 500 manifest_degraded lleva 60, a menos que el manejador establezca un valor más específico. | Problema (application/problem+json) |
| 429 | Problema estable rate_limited. Reintente solo después del intervalo Retry-After autorizado. Las denegaciones de ventana fija también incluyen la política RateLimit-Policy y los miembros RateLimit aplicables; las denegaciones por concurrencia y presupuesto de bytes omiten esas divulgaciones opcionales. | Problema (application/problem+json); encabezados: Retry-After, RateLimit-Policy, RateLimit |