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]