統計・ヘルスチェック

GET /v1/stats

プールの統計情報（カウンタ、バッファ占有量、タイムスタンプ）を返します。

curl -s "https://qrng.zhixuan.dev/v1/stats"

{
  "frames_processed": 48,
  "bytes_produced": 112800,
  "bytes_served": 304,
  "buffer_bytes": 112496,
  "buffer_capacity": 1048576,
  "started_at": "2026-06-17T23:09:44+09:00",
  "last_frame_at": "2026-06-17T23:09:45+09:00",
  "running": true
}

フィールド	型	意味
frames_processed	integer	処理済みのフレーム数
bytes_produced	integer	これまでに生成したバイト数
bytes_served	integer	これまでに配信したバイト数
buffer_bytes	integer	現在バッファに蓄積されているバイト数
buffer_capacity	integer	バッファの最大容量（バイト）
started_at	string	サーバー起動時刻（RFC 3339）
last_frame_at	string	直近フレームの取得時刻（RFC 3339）
running	boolean	エントロピーソースが稼働中かどうか

GET /v1/health

エントロピーソースの生存確認です。フレームが流れているときは 200、 ソースが停止しているとき（5 秒以内にフレームが来ない）は 503 を返します。 コンテナのヘルスチェックに利用できます。

curl -s "https://qrng.zhixuan.dev/v1/health"

{ "healthy": true }

ステータス	状態
200	フレームが流れている（正常）
503	ソースが停止している（5 秒以上無フレーム）