IP地址详情V4

接口说明

IP地址详情V4 提供基于 TxBxm 数据库的 IP 地理位置查询服务，支持 IPv4 与 IPv6 地址。通过提交待查询的 IP 地址，即可获取该地址对应的国家、省份、城市及运营商信息。本接口免费开放，适用于需要快速定位 IP 归属地的应用场景。

调用地址

/api/ip/v4

请求方式

GET、POST

鉴权说明

本接口必须使用密钥调用。首选鉴权方式为在请求 Query 参数中携带 key 字段传递密钥。

请求参数

参数补充说明

• key：必填参数，用于身份验证。缺失或无效时请求将无法正常返回数据。
• ip：必填参数，需为合法的 IP 地址字符串。支持完整的 IPv4 与 IPv6 地址格式。
• format：可选参数。指定 text 时返回纯文本格式；未指定或指定 json 时返回 JSON 格式。

成功响应示例

{
  "code": 0,
  "msg": "ok",
  "version": "1.1.0",
  "data": {
    "ip": "116.95.81.137",
    "country": "中国",
    "province": "内蒙古自治区",
    "city": "通辽市",
    "region": "",
    "countryCode": 156,
    "provinceCode": 15,
    "cityCode": 150500,
    "frontIsp": "中国联通",
    "backboneIsp": "中国联通",
    "address": "中国 内蒙古自治区 通辽市 中国联通"
  }
}

响应字段说明

错误响应示例

接口调用失败时，返回 JSON 格式的统一错误体，包含业务状态码 errcode 与提示信息 msg。示例：

{
  "code": 0,
  "msg": "密钥错误或已失效",
  "errcode": 11002
}

业务错误码说明

调用示例

终端 curl（bash）

# 查询 IP 地理位置信息（默认返回 JSON）
curl "https://api.example.com/api/ip/v4?key=YOUR_API_KEY&ip=112.64.69.167"

# 查询 IP 地理位置信息（指定 text 格式输出）
curl "https://api.example.com/api/ip/v4?key=YOUR_API_KEY&ip=112.64.69.167&format=text"

PHP

注意事项

• 密钥安全：key 为调用凭证，请妥善保管，切勿将密钥明文写在网页前端、公开代码仓库或分享给无关人员，避免被他人盗用。
• 请求方式：本接口支持 GET 与 POST，无论使用哪种方式，key 和 ip 均为必传参数，缺少任一参数将无法正常查询。
• IP 格式：ip 参数支持 IPv4 与 IPv6 地址，请确保传入的是合法地址格式；非法地址或无法识别的 IP 会返回错误结果。
• 输出格式：format 为可选参数，不传时默认返回 JSON 格式；如需简单文本输出，可显式传入 text。
• 接口限制：本接口为免费服务，请勿在短时间内高频调用或用于批量恶意请求，以免触发频率限制影响正常使用。
• 结果说明：返回数据中的 countryCode、provinceCode、cityCode 为地理区域编码，frontIsp 与 backboneIsp 分别为接入运营商与骨干运营商，实际字段值以查询结果为准，部分 IP 可能存在区域或运营商信息为空的情况。
• HTTPS 建议：为提高传输安全性，建议在服务端通过 HTTPS 协议调用本接口，避免请求参数在传输过程中被明文窃取。