Referência da API

API de Serviço e capacidades

Metadados do serviço, capacidades e busca na documentação

Referência HTTP. Gerada a partir do contrato backend. Navegue pelos endpoints abaixo ou baixe o OpenAPI.

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

GET/.health

Obter Health

Autenticação
nenhum
Corpo da solicitação
nenhum
ID da operação
getHealth
Modelo e respostas da solicitação
shell · modelo de requisição
curl --request GET 'https://api.screenrig.ai/.health'

Respostas

StatusSignificadoCorpo e cabeçalhos
200AtivoHealthResponse (application/json)
GET/.ready

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.

Autenticação
nenhum
Corpo da solicitação
nenhum
ID da operação
getReadiness
Modelo e respostas da solicitação
shell · modelo de requisição
curl --request GET 'https://api.screenrig.ai/.ready'

Respostas

StatusSignificadoCorpo e cabeçalhos
200ProntoReadyResponse (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)
GET/.version

Obter versão

Autenticação
nenhum
Corpo da solicitação
nenhum
ID da operação
getVersion
Modelo e respostas da solicitação
shell · modelo de requisição
curl --request GET 'https://api.screenrig.ai/.version'

Respostas

StatusSignificadoCorpo e cabeçalhos
200VersãoVersionResponse (application/json)
GET/api/capabilities

Obter capacidades

Autenticação
nenhum
Corpo da solicitação
nenhum
ID da operação
getCapabilities
Modelo e respostas da solicitação
shell · modelo de requisição
curl --request GET 'https://api.screenrig.ai/api/capabilities'

Respostas

StatusSignificadoCorpo e cabeçalhos
200Limites de capacidade e arquivoCapacidades (application/json)
GET/api/docs/search

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.

Autenticação
nenhum
Corpo da solicitação
nenhum
ID da operação
searchDocs

Parâmetros

NomeEnviarObrigatório?Descrição
qconsultaobrigatórioPalavras, um comando ou opção, ou um código de erro, de 1 a 200 caracteres.
limiteconsultaopcional
Modelo e respostas da solicitação
shell · modelo de requisição
curl --request GET 'https://api.screenrig.ai/api/docs/search?q=Q'

Respostas

StatusSignificadoCorpo e cabeçalhos
200As 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
GET/api/docs/page

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.

Autenticação
nenhum
Corpo da solicitação
nenhum
ID da operação
getDocsPage

Parâmetros

NomeEnviarObrigatório?Descrição
urlconsultaobrigatórioO endereço da página, de 1 a 500 caracteres.
sectionconsultaopcionalUm título ou âncora da página, no máximo 200 caracteres.
Modelo e respostas da solicitação
shell · modelo de requisição
curl --request GET 'https://api.screenrig.ai/api/docs/page?url=URL'

Respostas

StatusSignificadoCorpo e cabeçalhos
200A 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