Public API
CIDR
IPv4 / IPv6 の CIDR 表記から、ネットワーク / ブロードキャスト / 最初・最後のホスト / 使用可能数を計算します。
Endpoint
GET /api/v1/cidr?cidr=192.168.1.0/24
認証
認証なしで利用できます。匿名利用はIP単位のレート制限が適用されます。
パラメタ
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| cidr | string | 必須 | IPv4 または IPv6 の CIDR |
curl サンプル
curl "https://infra.yuzlrin.jp/api/v1/cidr?cidr=192.168.1.0/24"レスポンス例
{
"input": "192.168.1.0/24",
"isValid": true,
"version": 4,
"prefix": 24,
"networkAddress": "192.168.1.0",
"broadcastAddress": "192.168.1.255",
"firstHost": "192.168.1.1",
"lastHost": "192.168.1.254",
"totalAddresses": "256",
"usableHosts": "254",
"subnetMask": "255.255.255.0",
"wildcardMask": "0.0.0.255",
"binaryNetwork": "11000000.10101000.00000001.00000000"
}共通エラー
| Status | code | 意味 |
|---|---|---|
| 400 | missing_parameter / invalid_host / invalid_url / invalid_parameter / ssrf_blocked | 入力不正または SSRF 保護による拒否。ssrf_blocked は reason を含む場合があります。 |
| 401 | auth_required / invalid_api_key / api_key_required | ログインまたは API キーが必要です。Site Health Check は API キー専用です。 |
| 413 / 415 | payload_too_large / unsupported_media_type | POST JSON のサイズ超過または Content-Type 不一致。 |
| 429 | rate_limited | レスポンス本文に resetInSec、ヘッダに Retry-After を含みます。 |
| 500 | internal_error | 内部エラー。エラー応答は Cache-Control: no-store です。 |
{
"error": "Invalid URL",
"code": "invalid_url"
}
{
"error": "Rate limited",
"code": "rate_limited",
"resetInSec": 3600
}制限事項
- 匿名 30 回 / 日 / IP。
- SSRF 保護 — private IP / metadata ホストへのリクエストは拒否。
- 通信量・対象負荷を配慮した利用をお願いします。
- cidr パラメタ欠落時は 400 missing_parameter。不正な CIDR 値は 200 で isValid:false と errors を返します。