公开API
HxH Status 掌握的一切都以JSON提供。无需密钥,除常规缓存外没有额外限制,CORS对任何来源开放,每份文档都带有稳定的架构版本号。
接口
| 接口 | 返回内容 |
|---|---|
/api/v1/index.json | 接口索引、支持的语言,以及带版本号的图表地址。 |
/api/v1/status.json | 当前的刊载状态,以及追踪的所有话次。 |
/api/v1/stats.json | 依据1998年以来数据得出的休刊、刊载节奏与刊载率统计。 |
/api/v1/chapters.json | 跟踪章节索引。 |
/api/v1/chapters/{chapter}.json | 章节详情、标题和来源。 |
/api/v1/events.json | 已记录的状态及变化;并非完整历史。 |
/api/v1/togashi/latest.json | 富坚最新的一条发文,含全部已缓存译文。 |
/api/v1/togashi/posts.json | 已存档的富坚发文(由新到旧),含译文与入稿单转录。 |
/api/v1/togashi/latest/{locale}.json | 同样的文档,仅限单一语言。 |
/api/v1/openapi.json | 描述上述全部接口的 OpenAPI 3.1 文档。 |
订阅源、日历与徽章
| 接口 | 返回内容 |
|---|---|
/feed.xml | 追踪变更与富坚发文的 Atom 订阅源(英文)。 |
/{locale}/feed.xml | 同一 Atom 订阅源的其他已发布语言版本。 |
/releases.ics | 已确认刊登日期的日历订阅。 |
/badge/status.svg | 可嵌入的 SVG 状态徽章,亦提供各语言版本。 |
/share/{locale}/production.png | 制作追踪图与刊载历史图的 PNG 图像。 |
状态徽章
把当前状态嵌入 README 或粉丝站。追踪数据每次变更时图像都会重新生成。
[](https://hxhstatus.com)
机器可读的说明
一份 OpenAPI 3.1 文档描述了上述所有接口。 /api/v1/openapi.json
缓存与使用礼仪
每份文档都带有 ETag 和五分钟的缓存策略,每个响应都会给出 pollAfterSeconds 值。请予以尊重:追踪数据每月变动数次,而非每分钟数次。
署名
API 可免费使用。若能附上指向 hxhstatus.com 的链接,将有助于其他读者找到原始出处。