glitchmap

API

Всё, что показывает сайт, доступно в JSON. Без ключа, без регистрации, бесплатно.

Адреса

GET /api/v1/snapshot Вся картина разом: все сервисы, индекс, разбивка по состояниям и категориям.

GET /api/v1/services Список сервисов. Фильтры — category и status.

GET /api/v1/services/{slug} Один сервис: состояние, основание для него, проверки и сутки измерений.

GET /api/v1/services/{slug}/history?range=24h Доступность и задержка во времени. Диапазон — 24h, 7d, 30d или 90d.

GET /api/v1/incidents Наши собственные инциденты. active=1 — только открытые.

GET /api/v1/health Индекс здоровья — тот же, что на главной, — и состояние самого сбора данных.

Фиды

Atom, для читалок и чат-ботов: всё сразу или один сервис.

GET /feed/incidents.xml Все инциденты, которые мы записываем, свежие сверху.

GET /feed/services/{slug}.xml То же самое, но по одному сервису.

Кеширование

Ответы несут ETag и живут 15 секунд. Пришлите If-None-Match — и повторный запрос обойдётся в 304 вместо целого тела.

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

Ограничение частоты

120 запросов в минуту с клиента. Дальше — 429 и Retry-After. Ключа, поднимающего предел, нет: нужно больше — напишите, для чего.

Как пользоваться данными

Берите и стройте поверх. Ссылка обратно приятна, но не обязательна. Помните одно: это наши измерения с одного хоста плюс то, что вендоры пишут о себе, — не гарантия и не SLA.

Как устроены сами измерения — на странице о проверках. Как мы проверяем · [email protected]