网络

查询我的 IP

0次调用

2 积分/次

想知道你自己的出口公网IP是多少吗？这个接口就是你的“网络身份证”。默认返回标准结果；如果传 source=commercial，可以返回更完整的位置信息。

功能概述

调用此接口，它会返回你（即发起请求的客户端）的公网IP地址，并附带与 /network/ipinfo 接口相同的地理位置和网络归属信息。非常适合用于在网页上向用户展示他们自己的IP和地理位置。

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

查询参数

source

string可选

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

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

响应

200 / 请求成功

查询成功！返回你的客户端IP的详细信息。

JSON

400 / 错误的请求

无法获取有效的客户端IP。这在一些特殊的网络环境下可能发生，例如通过了复杂的代理。

JSON

500 / 服务器内部错误

服务器内部错误。在查询IP归属地信息时发生错误。

JSON

快速上手

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

认证方式：

cURL 命令

curl 'https://uapis.cn/api/v1/network/myip'

常见问题解答

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

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

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

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

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

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

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

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

上一篇查询 IP

下一篇Ping 主机

我们高兴地宣布，我们对项目内核心的 IP 地址查询 服务进行了一次重大的后端升级。

默认查询优化：我们引入了全新的、更精确的IP地理位置数据库，尤其对于国内IP的定位准确性，得到了巨大的提升。此项升级对现有调用无感知，无需改动代码即可享受到更精准的服务。
新增商业级查询：此外，我们新增了商业级IP归属查询功能。现在，您可以通过在 /network/ipinfo 或 /network/myip 端点中添加 source=commercial 参数，获取更详细、更精准的商业IP数据，包括行政区、区号、邮编、海拔、时区等。请注意，商业查询的响应时间可能稍长。

查询我的 IP

功能概述

查询参数

响应

200 / 请求成功

400 / 错误的请求

500 / 服务器内部错误