Checks エンドポイント

GET/api/v1/checks

1 ターゲットの可用性レコード・日次ポイント・対応する Agent オンライン系列を読み取ります。SLA グリッド・遅延ライン・障害タイムラインに適しています。

クエリパラメータ

パラメータ	必須	既定	範囲	目的
target_id	はい	—	有効な公開ターゲット ID	ターゲット
hours	いいえ	72	1–720	履歴ウィンドウ、最大 30 日
limit	いいえ	864	上限 12000、デプロイ調整 100–20000	チェックポイント最大数

curl -fsSL 'https://YOUR-API/api/v1/checks?target_id=vps-a&hours=72&limit=864'

レスポンス構造

{
  "ok": true,
  "source": "d1-check-buckets",
  "checks": [],
  "daily_points": [],
  "agent_series": []
}

フィールド	目的
checks[]	ウィンドウ内の Cloudflare チェックポイント。新しい順
daily_points[]	バケットから計算された日次表示データ
agent_series[]	Agent のオンライン履歴。Cloudflare チェックではない
source	現在の履歴ストレージソース

target_id が欠落すると HTTP 400 を返します。存在しない・無効・アドレス非公開のターゲットは空の履歴を返すことがあります。Status のターゲット一覧とプライバシーフィールドで判断し、管理 API にフォールバックしないでください。

チャートのアドバイス

1. 折れ線チャート用に checked_at で昇順にコピー・ソートする。
2. ok = false のポイントに 0 ms を偽装しない。
3. ズームリセット時は実際の最初/最後のタイムスタンプを復元する。
4. ポイントが 2 未満の場合は、引き伸ばしたトレンドではなく単一ポイント状態を表示する。
5. Cloudflare チェックと agent_series は別の凡例・ラベルを使う。

キャッシュ

正規化された target_id・hours・limit がキャッシュキーを構成します。既定キャッシュは約 60 秒で、0〜300 秒に調整できます。レスポンスは X-NIE-SLA-Cache: hit|miss と v1 互換の X-NStatus-Cache を返します。無意味なパラメータを追加しないでください。