网络

查询 IP

0次调用

2 积分/次

想知道一个IP地址或域名来自哪里？这个接口可以帮你定位它。默认返回标准结果；如果传 source=commercial，可以返回更完整的位置信息。

GET

uapis.cn

/api/v1/network/ipinfo

查询参数

string

required

你需要查询的公网IP地址或域名（支持IPv4和IPv6）。

source

string

Pro

查询结果类型。不传时返回标准结果；如果设置为 commercial，将返回更完整的地理位置信息，但响应时间可能会稍长。

功能概述

提供一个公网IPv4、IPv6地址或域名，我们会查询并返回它的地理位置（国家、省份、城市）、经纬度、以及所属的运营商（ISP）和自治系统（ASN）信息。这在网络安全分析、访问来源统计等领域非常有用。

当传 source=commercial 时，响应中会补充更完整的市、区、运营商、时区、海拔等信息，响应时间可能会稍长。

查询参数

ip

string必填

你需要查询的公网IP地址或域名（支持IPv4和IPv6）。

source

string可选

查询结果类型。不传时返回标准结果；如果设置为 commercial，将返回更完整的地理位置信息，但响应时间可能会稍长。

名称	类型	属性	说明
`ip`	string	必填	你需要查询的公网IP地址或域名（支持IPv4和IPv6）。
`source`	string	可选	查询结果类型。不传时返回标准结果；如果设置为 `commercial`，将返回更完整的地理位置信息，但响应时间可能会稍长。

响应

200 / 请求成功

查询成功！返回该IP地址的详细地理和网络信息。

JSON

{
  // 查询的IP地址
  "ip": "8.8.8.8",
  // 地理位置，格式：国家 省份 城市
  "region": "美国",
  // 运营商名称
  "isp": "GOOGLE",
  // 归属机构
  "llc": "GOOGLE",
  // 自治系统编号
  "asn": "AS15169",
  // 纬度
  "latitude": 37.751,
  // 经度
  "longitude": -97.822,
  // IP段起始地址（标准查询）
  "beginip": "8.8.8.0",
  // IP段结束地址（标准查询）
  "endip": "8.8.8.255"
}

400 / 错误的请求

IP地址参数无效。请检查 ip 参数是否提供，以及它是否是一个合法的公网IP地址。

JSON

{
  "code": "INVALID_ARGUMENT",
  "details": {},
  "message": "Invalid IP address provided."
}

404 / 未找到

信息未找到。这通常意味着你查询的是一个内网IP地址（如 192.168.x.x）或一个未分配的公网IP地址，我们的数据库中没有它的信息。

JSON

{
  "code": "NOT_FOUND",
  "details": {},
  "message": "Information for the given IP was not found in the database."
}

500 / 服务器内部错误

服务器内部错误。IP查询服务可能遇到了问题。

JSON

{
  "code": "INTERNAL_SERVER_ERROR",
  "details": {},
  "message": "An internal error occurred while querying IP information."
}

快速上手

选择你的语言查看调用示例

认证方式：

cURL 命令

curl 'https://uapis.cn/api/v1/network/ipinfo?ip=cn.bing.com'

常见问题解答

查询 IPAPI有什么特殊的使用限制吗？

查询 IPAPI 遵循我们的标准使用政策。具体的调用频率限制和参数要求请参考上方的接口文档。如有特殊需求，请与我们联系。

UAPI平台提供的API接口是完全免费的吗？

UAPI 平台为所有用户提供免费的访客积分，您可以直接调用所有接口。访客积分有一定的使用次数限制，如果需要更多积分，可以获取更多积分。

使用UAPI的API服务需要注册账号吗？

无需注册即可使用访客积分调用接口。如果您需要更多积分或想要管理自己的调用记录，可以免费注册账号。注册后您将获得更多免费积分，并可以在控制台查看详细的使用情况。

UAPI支持哪些编程语言和应用场景？

我们的API基于标准的HTTP协议和RESTful设计，理论上支持任何可以发送网络请求的编程语言，包括但不限于 JavaScript (Node.js, Vue, React), Python, Java, PHP, Go, C# 等。它们非常适合用于Web开发、移动APP后端、小程序云函数、自动化脚本等各种开发场景。

查询 IP

功能概述

查询参数

响应

200 / 请求成功

400 / 错误的请求

404 / 未找到

500 / 服务器内部错误

快速上手

cURL 命令

常见问题解答

查询 IPAPI有什么特殊的使用限制吗？

UAPI平台提供的API接口是完全免费的吗？

使用UAPI的API服务需要注册账号吗？

UAPI支持哪些编程语言和应用场景？

相关API

查询我的 IP

Ping 主机

执行DNS解析查询

查询天气

快速上手

cURL 命令

常见问题解答

查询 IPAPI有什么特殊的使用限制吗？

UAPI平台提供的API接口是完全免费的吗？

使用UAPI的API服务需要注册账号吗？

UAPI支持哪些编程语言和应用场景？

相关API

查询我的 IP

Ping 主机

执行DNS解析查询

查询天气