OpenAPI YAMLOpenAPI JSONproblemas YAMLVisão geral da API
Este grupo tem 6 operações, geradas a partir de api/openapi.yaml. Filtre por caminho, ação ou autenticação. Cada endpoint lista suas entradas; expanda-o para ver um modelo de solicitação e os códigos de resposta. Os modelos precisam de seus próprios valores e de um corpo válido conforme o esquema.
Substitua os espaços reservados em maiúsculas pelos seus valores. Para uma solicitação JSON, salve um corpo que corresponda ao esquema em request.json. Exemplos de cookies usam um jar local de cookies de uma sessão autenticada.
Metadados do serviço, capacidades e busca na documentação
Obter Health
Modelo e respostas da solicitação
curl --request GET 'https://api.screenrig.ai/.health'Respostas
| Status | Significado | Corpo e cabeçalhos |
|---|---|---|
| 200 | Ativo | HealthResponse (application/json) |
Obter prontidão
Pronto para servir. Um host em drenagem responde 421 server_draining com Retry-After: 1. Uma falha em dependência necessária responde 500 not_ready com Retry-After. Um esquema de banco de dados ativo que não satisfaz esta versão (um índice desejado ausente ou diferente por mais de dois minutos) responde 500 schema_incompatible sem Retry-After: não se resolve esperando.
Modelo e respostas da solicitação
curl --request GET 'https://api.screenrig.ai/.ready'Respostas
| Status | Significado | Corpo e cabeçalhos |
|---|---|---|
| 200 | Pronto | ReadyResponse (application/json) |
| 421 | Resposta de problema estável RFC 9457 em runtime, conteúdo ou rota de probe voltada ao Player, no formato de documento runtime (RuntimeProblem). Um 421 server_draining tem Retry-After de 1 segundo, um 500 not_ready ou dependency_unavailable tem 5, e um 500 manifest_degraded tem 60, a menos que o handler defina valor mais específico. | Problema Runtime (application/problem+json) |
| 500 | Resposta de problema estável RFC 9457 em runtime, conteúdo ou rota de probe voltada ao Player, no formato de documento runtime (RuntimeProblem). Um 421 server_draining tem Retry-After de 1 segundo, um 500 not_ready ou dependency_unavailable tem 5, e um 500 manifest_degraded tem 60, a menos que o handler defina valor mais específico. | Problema Runtime (application/problem+json) |
Obter versão
Modelo e respostas da solicitação
curl --request GET 'https://api.screenrig.ai/.version'Respostas
| Status | Significado | Corpo e cabeçalhos |
|---|---|---|
| 200 | Versão | VersionResponse (application/json) |
Obter capacidades
Modelo e respostas da solicitação
curl --request GET 'https://api.screenrig.ai/api/capabilities'Respostas
| Status | Significado | Corpo e cabeçalhos |
|---|---|---|
| 200 | Limites de capacidade e arquivo | Capacidades (application/json) |
Pesquisar na documentação oficial
Pesquisa na documentação oficial do screenRIG, nas páginas de screenrig.ai/docs, nos tipos de problema, nos preços e nas demais páginas para clientes, e retorna as seções que melhor correspondem, da mais relevante para a menos relevante, no máximo limit (8 por padrão). Público: nenhuma credencial é necessária e a chamada nunca é cobrada.
A url de um resultado é a sua página (com o fragmento da seção quando a página nomeia um), section é o título e snippet mostra o texto em torno da correspondência; leia a página ou a seção com getDocsPage. Limitado a 120 solicitações por IP de cliente por minuto (IPv6 agrupado por /64).
O corpus é recarregado a cada 15 minutos; antes do primeiro carregamento, a rota responde 500 not_ready com Retry-After.
Parâmetros
| Nome | Enviar | Obrigatório? | Descrição |
|---|---|---|---|
| q | consulta | obrigatório | Palavras, um comando ou opção, ou um código de erro, de 1 a 200 caracteres. |
| limite | consulta | opcional |
Modelo e respostas da solicitação
curl --request GET 'https://api.screenrig.ai/api/docs/search?q=Q'Respostas
| Status | Significado | Corpo e cabeçalhos |
|---|---|---|
| 200 | As seções correspondentes, da mais relevante para a menos relevante. Vazio quando nada corresponde. | DocsSearchResponse (application/json); cabeçalhos: RateLimit-Policy, RateLimit |
| padrão | Resposta de problema estável RFC 9457. Um 421 server_draining tem Retry-After de 1 segundo, um 500 not_ready ou dependency_unavailable tem 5, e um 500 manifest_degraded tem 60, a menos que o handler defina valor mais específico. | Problema (application/problem+json) |
| 429 | Problema estável rate_limited. Refaça só após o intervalo Retry-After autoritativo. Negativas de janela fixa incluem também RateLimit-Policy e membros RateLimit aplicáveis; negativas de concorrência e orçamento de bytes omitem essas divulgações opcionais. | Problema (application/problem+json); cabeçalhos: Retry-After, RateLimit-Policy, RateLimit |
Ler uma página ou seção da documentação oficial
Retorna uma página da documentação oficial ou, com section, uma única seção dela com as subseções, em Markdown. url é o endereço da página como searchDocs o retorna, sua forma .md ou só o caminho, com ou sem #fragment (um fragmento nomeia a seção quando section não é informado). section é um título ou uma âncora da página, ou parte de um título.
Uma seção é cortada em um fim de linha dentro de 48 KiB, com truncated true; uma página inteira com mais de 48 KiB responde com sua introdução e sua estrutura de tópicos, com truncated true. sections lista os títulos a ler em seguida (os da página ou os subtítulos da própria seção). Páginas e seções desconhecidas respondem 404 not_found.
Público, nunca cobrado e limitado às mesmas 120 solicitações por IP de cliente por minuto que searchDocs.
Parâmetros
| Nome | Enviar | Obrigatório? | Descrição |
|---|---|---|---|
| url | consulta | obrigatório | O endereço da página, de 1 a 500 caracteres. |
| section | consulta | opcional | Um título ou âncora da página, no máximo 200 caracteres. |
Modelo e respostas da solicitação
curl --request GET 'https://api.screenrig.ai/api/docs/page?url=URL'Respostas
| Status | Significado | Corpo e cabeçalhos |
|---|---|---|
| 200 | A página ou seção como Markdown. | DocsPage (application/json); cabeçalhos: RateLimit-Policy, RateLimit |
| padrão | Resposta de problema estável RFC 9457. Um 421 server_draining tem Retry-After de 1 segundo, um 500 not_ready ou dependency_unavailable tem 5, e um 500 manifest_degraded tem 60, a menos que o handler defina valor mais específico. | Problema (application/problem+json) |
| 429 | Problema estável rate_limited. Refaça só após o intervalo Retry-After autoritativo. Negativas de janela fixa incluem também RateLimit-Policy e membros RateLimit aplicáveis; negativas de concorrência e orçamento de bytes omitem essas divulgações opcionais. | Problema (application/problem+json); cabeçalhos: Retry-After, RateLimit-Policy, RateLimit |