REST / MCP / SDK
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.
Início rápido
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/servicesPesquise e navegue pelas páginas do catálogo de serviços.GET /v1/statusConsulte o estado salvo atual de um serviço.GET /v1/statusesConsulte o estado de vários serviços em uma solicitação.GET /v1/summaryResuma os sinais observados para uma região ou para serviços selecionados.GET /v1/historyConsulte observações salvas ao longo do tempo, com paginação.GET /v1/statsCalcule proporções de amostras de sinais salvas, em vez de disponibilidade medida.GET /v1/incidentsListe 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.
Todos os serviçosLicenç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.
Os pagamentos, as renovações, as alterações de plano e o gerenciamento de licenças são feitos pelo Evelode.com. A cota de solicitações é redefinida quando a licença é renovada ou o plano é alterado. Ela não é redefinida no início de cada mês. Os planos anuais incluem um saldo único de solicitações equivalente a 12 cotas de um período da licença, válido por todo o período anual. O histórico é acumulado desde o início da coleta. O plano Free não tem cobrança recorrente.
PreçosConecte um assistente de IA
Adicione o URL do servidor ao assistente, selecione OAuth e entre com Evelode ou introduza a chave de licença no ecrã de conexão. Não é necessário um segredo de cliente.
https://mcp.uptimescout.com Authorization: Bearer YOUR_EVELODE_LICENSE_KEY
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.
Exemplo de observações salvas
{
"available_regions": [
"AE",
"AR",
"AT",
"AU",
"AZ",
"BD",
"BE",
"BG",
"BH",
"BR",
"CA",
"CH",
"CL",
"CO",
"CR",
"CZ",
"DE",
"DK",
"DO",
"DZ",
"EC",
"EG",
"ES",
"FI",
"FR",
"GB",
"GR",
"GT",
"HK",
"HR",
"HU",
"ID",
"IE",
"IL",
"IN",
"IT",
"JO",
"JP",
"KE",
"KR",
"MA",
"MX",
"MY",
"NG",
"NL",
"NO",
"NZ",
"PA",
"PE",
"PH",
"PK",
"PL",
"PR",
"PT",
"PY",
"RO",
"RS",
"RU",
"SA",
"SE",
"SG",
"SK",
"TH",
"TN",
"TR",
"TW",
"UA",
"US",
"UY",
"VE",
"VN",
"ZA"
],
"data_type": "availability_observations",
"generated_at": "2026-11-18T18:55:17.818410Z",
"region": "US",
"service": {
"age_seconds": 16,
"category": "it",
"description": "Plataforma para reposit\u00f3rios Git, colabora\u00e7\u00e3o em c\u00f3digo, problemas e entrega de software.",
"description_language": "pt",
"id": "github",
"logo_kind": "brand",
"logo_url": "https://uptimescout.com/static/brand-assets/github.svg?v=18e8fe76f953a31c",
"name": "GitHub",
"observed_at": "2026-11-18T18:55:01.987427Z",
"regions": [
"US"
],
"scope": "regional",
"signal": "reported_availability",
"stale": false,
"status": "outage"
},
"stale_after_seconds": 600,
"status": "ok"
}