ランダム生成エンドポイント

`GET /`

サービスのメタデータと、エンドポイント・フォーマットの一覧を返します。

curl https://qrng.zhixuan.dev/

`GET /v1/random/{format}?bytes=N`

要求されたフォーマットで N 単位のランダム値を返します。format には下表のいずれかを指定します。

フォーマット	Content-Type	出力
`raw`	`application/octet-stream`	`N` 個の生のランダムバイト
`hex`	`text/plain`	`N` バイトの小文字 16 進文字列（`2N` 文字）
`base64`	`text/plain`	`N` バイトの標準 base64
`ascii`	`text/plain`	`N` 文字の印字可能 ASCII `0x21–0x7E`、一様（棄却サンプリング）

# 64 バイトの生データをファイルへ
curl -s "https://qrng.zhixuan.dev/v1/random/raw?bytes=64" -o random.bin

# 16 バイトを 16 進で
curl -s "https://qrng.zhixuan.dev/v1/random/hex?bytes=16"
# => e42a1cdf654dbe13261933e408083b19

# 24 バイトの base64 トークン
curl -s "https://qrng.zhixuan.dev/v1/random/base64?bytes=24"

# 32 文字のランダムなパスワード
curl -s "https://qrng.zhixuan.dev/v1/random/ascii?n=32"
# => Q;D.iKI'54E~:#.ztM[1@d42?X=g%S?[

注記

ascii では、N は入力バイト数ではなく 生成される文字数 です。

`GET /v1/random/json?bytes=N`

N バイトのランダム値を、base64 と hex の両方およびメタデータを含む JSON エンベロープで返します。

curl -s "https://qrng.zhixuan.dev/v1/random/json?bytes=8"

{
  "bytes": 8,
  "base64": "c6zaMVG2NUA=",
  "hex": "73acda3151b63540",
  "generated_at": "2026-06-17T14:09:45.812384Z"
}

フィールド	型	意味
`bytes`	integer	生成されたバイト数
`base64`	string	ランダムバイトの標準 base64
`hex`	string	ランダムバイトの小文字 16 進
`generated_at`	string	生成時刻（RFC 3339 / UTC）

GET /​

GET /v1/random/{format}?bytes=N​

GET /v1/random/json?bytes=N​

`GET /`

`GET /v1/random/{format}?bytes=N`

`GET /v1/random/json?bytes=N`