glitchmap

API

サイトに表示される内容はすべて JSON でも取得できます。キーも登録も不要、無料です。

エンドポイント

GET /api/v1/snapshot 全体像を一度に。全サービス、指数、状態別・カテゴリ別の内訳。

GET /api/v1/services サービス一覧。category と status で絞り込めます。

GET /api/v1/services/{slug} 単一サービス。状態とその根拠、チェック、直近 1 日の計測値。

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 リクエスト。超えると Retry-After 付きの 429 を返します。上限を上げる鍵はありません。必要なら用途を添えてご連絡ください。

データの利用

自由に使って、その上に何かを作ってください。リンクはうれしいですが必須ではありません。ひとつだけ留意を。これは一箇所から取った当サイトの計測と、提供元が自ら公表している内容であって、保証でも SLA でもありません。

計測の仕組みは、チェックについてのページで説明しています。チェックについて · [email protected]