# IP子网计算

**请求方式：** GET

**接口地址：** https://api.hk0.cc/api/subnet

**接口描述：** IPv4 子网计算器：根据 CIDR 或 IP+掩码返回网络地址、广播地址、可用主机范围、掩码/通配符、主机数，并可判断某 IP 是否属于该子网。参数: cidr 或 ip(+mask); contains(可选)

## 请求参数

| 参数名 | 可传值说明 | 传入位置 | 是否必填 | 示例值 | 默认值 | 参数说明 |
|--------|----------|----------|----------|--------|--------|----------|
| cidr | string | query | 必传 | — | — | CIDR 表示，如 192.168.1.0/24 |
| ip | string | query | 可选 | — | — | IPv4 地址，与 mask 配合使用 |
| mask | string | query | 可选 | — | — | 掩码，支持前缀长度或点分格式，默认 /32 |
| contains | string | query | 可选 | — | — | 可选，判断该 IP 是否属于此子网 |

## 返回示例

```json
GET /api/subnet?cidr=192.168.1.100%2F24&contains=192.168.1.200
```