Status エンドポイント
/api/v1/status公開ターゲット・現在状態・SLA サマリー・インシデント・フロントエンドの外観・Ping ターゲット・最新の Agent テレメトリを返します。代替フロントエンドの主要エントリポイントです。
クエリパラメータ
| パラメータ | 必須 | 既定 | 範囲 | 目的 |
|---|---|---|---|---|
days | いいえ | サーバー既定 | 1–90 | 日次サマリーと SLA 範囲 |
lite | いいえ | 0 | 0 または 1 | 1 は初回描画向けデータを返す |
curl -fsSL 'https://YOUR-API/api/v1/status?days=30&lite=1'トップレベルフィールド
| フィールド | 目的 |
|---|---|
name | 公開サイト名 |
now | サーバーの ISO 時刻 |
days | レスポンスに含まれる日付一覧 |
regions | リージョンコードから表示名へ |
region_proxy_enabled | リージョナル Durable Object バインディング |
frontend_theme | 内蔵テーマ名 |
frontend | 公開フィルタ済みのテーマ・外観設定 |
traffic | 現在のトラフィック期間の説明 |
privacy | IP・ポート・データセンター情報の公開ポリシー |
storage | ストレージ機能とキャッシュ TTL |
timezone | SLA 集約タイムゾーン |
targets[] | ターゲットプロファイル・現在チェック・Agent 状態・遅延ソース |
summaries[] | ターゲットごとの日次 SLA 集約 |
incidents[] | 直近の障害・復旧イベント |
ping_targets[] | 有効な Agent TCP Ping ターゲット |
warnings[] | 致命的でない同期・データ警告 |
targets[] の主要フィールド
id・name・group_name・type：安定した識別子と分類。location・city・provider・line_type：公開プロフィール。ok・checked_at・latency_ms：現在の Cloudflare チェック。agent_online・last_metrics_at・agent_version：Rust Agent の状態。agent_metrics：公開フィルタ済みの最新システムメトリクス。latency_sources[]：鮮度ウィンドウ内の Cloudflare・外部ソース。has_nq・nq：NodeQuality レポートの有無と更新日時。unlock：手動 IPv4 アンロックチェックのサニタイズ済みサービス結果。no_public_ip：ターゲットの IP・ポート・アクティブ遅延データを隠す。
ok は Cloudflare の能動チェック、agent_online はメトリクス Agent が直近に報告したかどうかです。別々に表示し、一方が他方を上書きしないようにしてください。
agent_metrics.vps_info.total_disk_gb はルートファイルシステムの容量であり、マウントの合計ではありません。同一デバイスのバインドマウントは二重計上されません。
Lite モード
初回描画には lite=1 を要求し、チェック・メトリクス・Ping・遅延は詳細を開いたときに読み込みます。Lite はターゲット・サマリー・インシデント・プライバシー・外観・警告を保持し、ターゲットの日別詳細や agent_metrics.pings のような重いフィールドを除外します。
時刻と順序
サーバー時刻はクライアントと異なることがあります。「直近に報告」を計算するときは now を基準にし、履歴配列は数値タイムスタンプで明示的にソートしてください。
プライバシー
サーバーはデプロイ設定に従い、IP をマスクし、ポートを隠し、URL 資格情報を除去し、内部エラーの詳細を削除します。他の公開フィールドから再構築しようとせず、管理 API データを公開ステータスの代わりにキャッシュしないでください。
no_public_ip の TCP ターゲットでは、Cloudflare チェックと外部遅延が隠され、status_source は Agent になり、ok/checked_at/latency_ms は null になり得ます。Agent のオンライン状態のみを表示し、null を障害と解釈しないでください。
キャッシュと警告
既定のステータスキャッシュは約 20 秒で、0〜300 秒に調整できます。公開 v1 は fresh=1 でこれを回避できません。有効な管理セッションを持つ内部ステータスリクエストだけが強制更新します。warnings[] は任意ソースの劣化を意味し、メインターゲットは描画され続けます。