RATATOSKRATATOSK
ログイン

REST API

facts をプログラムから直接照会できる、読み取り専用の公開 API です。

  • 認証なし。IP あたり毎分 60 リクエストまで。
  • 時刻はすべて UTC、レスポンスは JSON。
  • 正式な仕様は API 自身が記述しています。https://ratatosk.io/v1 を 開くと、全エンドポイント・パラメータ・例を含むインデックスが返ります。

エンドポイント

パス 用途
GET /v1 自己記述インデックス(この API の正式リファレンス)
GET /v1/facts fact の増分フィード。project type severity since limit で絞り込み
GET /v1/facts/by-entity 逆引き: 一つの識別子(CVE・CRD・フラグなど)に触れたすべての fact
GET /v1/releases/{project}/{version} リリース一件のレビュー全体。include=raw で原文も含む

例

直近の critical facts を 5 件:

curl "https://ratatosk.io/v1/facts?severity=critical&limit=5"

特定の CVE に触れた fact を探す:

curl "https://ratatosk.io/v1/facts/by-entity?name=CVE-2026-33186"

リリース一件を原文付きで:

curl "https://ratatosk.io/v1/releases/thanos/v0.42.0?include=raw"

増分ポーリング

/v1/facts は fact_id の昇順です。レスポンスの next_since を次の リクエストの since に渡すと、新しい fact だけを続きから受け取れます。 定期的に全件を取り直す代わりに、このカーソルを使ってください。

利用条件

分析は AI が生成し、無保証で提供されます。検証用の出典が常に併記されます。 詳細は利用規約を参照してください。