Referencia API

API de Servicio y capacidades

Metadatos del servicio, capacidades y búsqueda en la documentación

Referencia HTTP. Generada a partir del contrato backend. Explore los endpoints abajo o descargue OpenAPI.

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

GET/.health

Obtener Health

Autenticación
ninguno
Cuerpo de la solicitud
ninguno
ID de operación
getHealth
Plantilla y respuestas de solicitud
shell · plantilla de solicitud
curl --request GET 'https://api.screenrig.ai/.health'

Respuestas

EstadoSignificadoCuerpo y encabezados
200ActivoHealthResponse (application/json)
GET/.ready

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.

Autenticación
ninguno
Cuerpo de la solicitud
ninguno
ID de operación
getReadiness
Plantilla y respuestas de solicitud
shell · plantilla de solicitud
curl --request GET 'https://api.screenrig.ai/.ready'

Respuestas

EstadoSignificadoCuerpo y encabezados
200ListoReadyResponse (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)
GET/.version

Obtener versión

Autenticación
ninguno
Cuerpo de la solicitud
ninguno
ID de operación
getVersion
Plantilla y respuestas de solicitud
shell · plantilla de solicitud
curl --request GET 'https://api.screenrig.ai/.version'

Respuestas

EstadoSignificadoCuerpo y encabezados
200VersiónRespuestaDeVersión (application/json)
GET/api/capabilities

Obtener capacidades

Autenticación
ninguno
Cuerpo de la solicitud
ninguno
ID de operación
getCapabilities
Plantilla y respuestas de solicitud
shell · plantilla de solicitud
curl --request GET 'https://api.screenrig.ai/api/capabilities'

Respuestas

EstadoSignificadoCuerpo y encabezados
200Límites de capacidad y archivoCapacidades (application/json)
GET/api/docs/search

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.

Autenticación
ninguno
Cuerpo de la solicitud
ninguno
ID de operación
searchDocs

Parámetros

NombreEnviar¿Requerido?Descripción
qconsultarequeridoPalabras, un comando u opción, o un código de error, de 1 a 200 caracteres.
límiteconsultaopcional
Plantilla y respuestas de solicitud
shell · plantilla de solicitud
curl --request GET 'https://api.screenrig.ai/api/docs/search?q=Q'

Respuestas

EstadoSignificadoCuerpo y encabezados
200Las 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
GET/api/docs/page

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.

Autenticación
ninguno
Cuerpo de la solicitud
ninguno
ID de operación
getDocsPage

Parámetros

NombreEnviar¿Requerido?Descripción
urlconsultarequeridoLa dirección de la página, de 1 a 500 caracteres.
sectionconsultaopcionalUn encabezado o ancla de la página, como máximo 200 caracteres.
Plantilla y respuestas de solicitud
shell · plantilla de solicitud
curl --request GET 'https://api.screenrig.ai/api/docs/page?url=URL'

Respuestas

EstadoSignificadoCuerpo y encabezados
200La 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