IP 网段计算

请求地址	https://cx4.cn/openApi/dev/netmask 复制
请求方式	GET / POST
接口标识	dev_netmask
鉴权方式	必须 四种方式任选其一：Header「X-Api-Key」/ Header「Authorization: Bearer 你的key」/ URL 参数「?key=你的key」/ POST 参数「key」

参数名	类型	必填	说明	示例
action	string	否	cidr 网段详情 / to_int IP 转整数 / to_ip 整数转 IP / contains 判断是否包含	cidr
cidr	string	否	CIDR 网段，action=cidr/contains 时使用	192.168.1.0/24
ip	string	否	IP 地址，action=to_int/contains 时使用	192.168.1.100
num	string	否	IP 对应的无符号整数 0-4294967295，action=to_ip 时使用	3232235876

下表字段位于返回结构的 data 内；外层 code / message 为全平台统一格式，不在此重复列出。

参数名	类型	说明	示例
ok	bool	是否成功	true
action	string	执行的操作	cidr
cidr	string	网段	192.168.1.0/24
network	string	网络地址	192.168.1.0
netmask	string	子网掩码	255.255.255.0
wildcard	string	通配符掩码	0.0.0.255
broadcast	string	广播地址	192.168.1.255
first_usable	string	第一个可用地址	192.168.1.1
last_usable	string	最后一个可用地址	192.168.1.254
total_addresses	int	地址总数	256
usable_hosts	int	可用主机数	254
bits	int	掩码位数	24

成功

{
    "code": 200,
    "message": "操作成功",
    "data": {
        "ok": true,
        "action": "cidr",
        "cidr": "192.168.1.0/24",
        "network": "192.168.1.0",
        "netmask": "255.255.255.0",
        "wildcard": "0.0.0.255",
        "broadcast": "192.168.1.255",
        "first_usable": "192.168.1.1",
        "last_usable": "192.168.1.254",
        "total_addresses": 256,
        "usable_hosts": 254,
        "bits": 24
    }
}

失败

{
    "code": 400,
    "message": "不是合法的 CIDR 网段",
    "data": null
}

状态码	说明
200	调用成功
400	缺少必填参数或参数格式有误
401	密钥缺失或无效
402	余额不足，请充值后重试
403	未开通该接口，请在本页开通后调用
404	接口不存在或已下架
429	触发限流，请稍后重试
500	接口调用失败（已扣款的会自动退款）

cURL 复制

curl -X POST "https://cx4.cn/openApi/dev/netmask" -H "X-Api-Key: 你的SecretKey" -d "action=cidr&cidr=192.168.1.0/24&ip=192.168.1.100&num=3232235876"

JavaScript 复制

fetch('https://cx4.cn/openApi/dev/netmask', {
  method: 'POST',
  headers: {
    'X-Api-Key': '你的SecretKey',
    'Content-Type': 'application/x-www-form-urlencoded'
  },
  body: 'action=cidr&cidr=192.168.1.0/24&ip=192.168.1.100&num=3232235876'
})
.then(res => res.json())
.then(data => console.log(data));

PHP 复制

post('https://cx4.cn/openApi/dev/netmask', [
    'headers' => ['X-Api-Key' => '你的SecretKey'],
    'form_params' => ['action' => 'cidr', 'cidr' => '192.168.1.0/24', 'ip' => '192.168.1.100', 'num' => '3232235876'],
]);
echo $response->getBody();

Java 复制

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://cx4.cn/openApi/dev/netmask"))
    .header("X-Api-Key", "你的SecretKey")
    .header("Content-Type", "application/x-www-form-urlencoded")
    .POST(HttpRequest.BodyPublishers.ofString("action=cidr&cidr=192.168.1.0/24&ip=192.168.1.100&num=3232235876"))
    .build();
HttpResponse response = client.send(
        request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Python 复制

import requests

res = requests.post('https://cx4.cn/openApi/dev/netmask',
    headers={'X-Api-Key': '你的SecretKey'},
    data={'action': 'cidr', 'cidr': '192.168.1.0/24', 'ip': '192.168.1.100', 'num': '3232235876'})
print(res.json())

登录后可在线测试： 立即登录