首页 开发文档 IP信息

IP信息

查询IP的归属地信息,返回国家、区域、省份、城市、运营商。

请求信息
请求地址 https://cx4.cn/openApi/dev/ip_info 复制
请求方式 GET / POST
接口标识 dev_ip_info
鉴权方式 必须
四种方式任选其一:Header「X-Api-Key」/ Header「Authorization: Bearer 你的key」/ URL 参数「?key=你的key」/ POST 参数「key」
请求参数
参数名 类型 必填 说明 示例
ip string 否 要查询的IP地址,留空则查询当前请求方IP 8.8.8.8
返回参数

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

参数名 类型 说明 示例
country string 国家 中国
region string 区域(通常为空)
province string 省份 广东省
city string 城市 深圳市
isp string 运营商 电信
ip string 查询的IP地址 8.8.8.8
返回示例

成功

{
    "code": 200,
    "message": "操作成功",
    "data": {
        "country": "美国",
        "region": "",
        "province": "",
        "city": "",
        "isp": "",
        "ip": "8.8.8.8"
    }
}

失败

{
    "code": 500,
    "message": "IP地址非法",
    "data": null
}
平台通用状态码
状态码 说明
200调用成功
400缺少必填参数或参数格式有误
401密钥缺失或无效
402余额不足,请充值后重试
403未开通该接口,请在本页开通后调用
404接口不存在或已下架
429触发限流,请稍后重试
500接口调用失败(已扣款的会自动退款)
调用示例

cURL 复制

curl -X POST "https://cx4.cn/openApi/dev/ip_info" -H "X-Api-Key: 你的SecretKey" -d "ip=8.8.8.8"

JavaScript 复制

fetch('https://cx4.cn/openApi/dev/ip_info', {
  method: 'POST',
  headers: {
    'X-Api-Key': '你的SecretKey',
    'Content-Type': 'application/x-www-form-urlencoded'
  },
  body: 'ip=8.8.8.8'
})
.then(res => res.json())
.then(data => console.log(data));

PHP 复制

post('https://cx4.cn/openApi/dev/ip_info', [
    'headers' => ['X-Api-Key' => '你的SecretKey'],
    'form_params' => ['ip' => '8.8.8.8'],
]);
echo $response->getBody();

Java 复制

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://cx4.cn/openApi/dev/ip_info"))
    .header("X-Api-Key", "你的SecretKey")
    .header("Content-Type", "application/x-www-form-urlencoded")
    .POST(HttpRequest.BodyPublishers.ofString("ip=8.8.8.8"))
    .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/ip_info',
    headers={'X-Api-Key': '你的SecretKey'},
    data={'ip': '8.8.8.8'})
print(res.json())
在线测试 (使用你的密钥真实调用,计费与正常调用一致)

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

计费说明

¥0.0010

每次调用


每日免费额度:无

累计调用:22 次


快速上手

1. 注册并完成邮箱验证:立即注册

2. 登录后复制 Secret Key:去登录

3. 点击右侧「开通接口」按钮

4. 用下方「在线测试」一键体验,或复制下方示例代码直接调用