API

Tudo o que o site mostra está disponível em JSON. Sem chave, sem cadastro, de graça.

Endpoints

GET /api/v1/snapshot O quadro inteiro de uma vez: todos os serviços, o índice e a divisão por estado e categoria.

GET /api/v1/services A lista de serviços. Filtros: category e status.

GET /api/v1/services/{slug} Um serviço: estado, o motivo por trás, verificações e um dia de medições.

GET /api/v1/services/{slug}/history?range=24h Disponibilidade e latência ao longo do tempo. O intervalo é 24h, 7d, 30d ou 90d.

GET /api/v1/incidents Nossos próprios incidentes. Com active=1, apenas os abertos.

GET /api/v1/health O índice de saúde, o mesmo da página inicial, e o estado da nossa própria coleta.

Feeds

Atom, para leitores e bots de chat: tudo ou apenas um serviço.

GET /feed/incidents.xml Todos os incidentes que registramos, os mais recentes primeiro.

GET /feed/services/{slug}.xml O mesmo, restrito a um serviço.

Cache

As respostas trazem ETag e vivem 15 segundos. Envie If-None-Match e uma repetição custa 304 em vez do corpo inteiro.

curl -sI https://glitchmap.com/api/v1/health | grep -i etag
curl -s -H 'If-None-Match: "..."' -o /dev/null -w '%{http_code}\n' https://glitchmap.com/api/v1/health

Limite de frequência

120 requisições por minuto por cliente. Além disso, 429 com Retry-After. Nenhuma chave aumenta o limite: se precisar de mais, escreva para quê.

Uso dos dados

Pegue e construa em cima. Um link de volta é bem-vindo, mas não é exigido. Tenha uma coisa em mente: são nossas medições a partir de um host, mais o que os fornecedores publicam sobre si mesmos — não é garantia nem SLA.

Como as medições são feitas está descrito na página sobre as verificações. Sobre as verificações · [email protected]