# Documentação da API do UptimeScout

Status dos serviços, sinais regionais e histórico por REST, SDKs e MCP. Crie painéis e dê aos assistentes de IA informações claras sobre a disponibilidade.

URL: https://uptimescout.com/pt/docs/

## REST

```sh
curl -G https://api.uptimescout.com/v1/status --data-urlencode "service=github" --data-urlencode "region=US" -H "Authorization: Bearer $EVELODE_LICENSE_KEY"
```

## Métodos disponíveis

- `GET /v1/services`: Pesquise e navegue pelas páginas do catálogo de serviços.

- `GET /v1/status`: Consulte o estado salvo atual de um serviço.

- `GET /v1/statuses`: Consulte o estado de vários serviços em uma solicitação.

- `GET /v1/summary`: Resuma os sinais observados para uma região ou para serviços selecionados.

- `GET /v1/history`: Consulte observações salvas ao longo do tempo, com paginação.

- `GET /v1/stats`: Calcule proporções de amostras de sinais salvas, em vez de disponibilidade medida.

- `GET /v1/incidents`: Liste serviços com sinais elevados; eles não representam incidentes globais confirmados.

## Como os dados funcionam

O UptimeScout armazena observações regionais em segundo plano. Cada resposta inclui o horário da observação e informações sobre sua atualização. O mesmo serviço pode apresentar sinais diferentes em regiões distintas.

O estado `operational` significa que não foi observada uma interrupção acima do normal naquela amostra salva. Os estados `degraded` e `outage` descrevem condições observadas, não um incidente global confirmado. Observações ausentes ou desatualizadas são `unknown`. As proporções das amostras não são percentuais de disponibilidade medidos nem um SLA.

A coleta ocorre continuamente em diferentes regiões e serviços. Confira o horário da observação e a atualidade dos dados de cada serviço para avaliar quão recentes são as informações de status.

O idioma controla como as informações são apresentadas; a região de observação controla a qual país os dados se referem. Você pode alterá-los de forma independente. Uma página traduzida não implica automaticamente observações de um país específico.

## Licença e limites de solicitações

Use sua chave de licença Evelode como um token Bearer. Mantenha-a no servidor, fora do código do navegador e de repositórios públicos. Somente solicitações de dados licenciadas e bem-sucedidas consomem a cota. A renovação de uma licença ou a alteração do plano inicia uma nova cota; os meses do calendário não a redefinem. Os planos anuais oferecem um saldo de solicitações equivalente a 12 cotas de um período de licença, válido durante todo o período anual.

## Conecte um assistente de IA

Conecte um cliente MCP com Streamable HTTP ao endpoint abaixo e informe sua chave de licença no cabeçalho Authorization. Sete ferramentas somente de leitura fornecem status dos serviços, sinais regionais e histórico. Os mesmos limites da licença se aplicam.

https://mcp.uptimescout.com

## Tratamento das respostas

Verifique o estado HTTP antes de ler os dados: 400 indica parâmetros inválidos; 401 ou 403 indica um problema de autenticação ou licença; 409 significa que os direitos da licença mudaram durante uma solicitação; 429 indica um limite de solicitações ou de frequência; e 503 indica indisponibilidade temporária. Respeite os intervalos de espera antes de tentar novamente e evite repetir solicitações em sequência rápida.

OpenAPI: https://uptimescout.com/openapi.json
