网络

获取你的公网IP及归属信息

0次调用

想知道你自己的出口公网IP是多少吗?这个接口就是你的“网络身份证”。你可以选择使用默认的GeoIP数据库,也可以指定 source=commercial 参数来查询更详细的商业级IP归属信息。

GET
uapis.cn
/api/v1/network/myip
查询参数
1
source
string

查询的数据源。如果留空,将使用默认的数据库。如果设置为 commercial,将调用商业级API,返回更详细的地理位置信息,但响应时间可能会稍长。

功能概述

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

当使用 source=commercial 参数时,接口将调用高性能商业API,提供更精确的市、区、运营商、时区、海拔等信息。请注意,商业查询的响应时间可能会稍长。

查询参数

source
string

查询的数据源。如果留空,将使用默认的数据库。如果设置为 commercial,将调用商业级API,返回更详细的地理位置信息,但响应时间可能会稍长。

响应

200 / 请求成功

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

示例 1:标准查询 (不带 source 参数)

请求: /api/v1/network/myip

响应:

示例 2:商业数据源查询 (source=commercial)

请求: /api/v1/network/myip?source=commercial

响应:

400 / 错误的请求

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

500 / 服务器内部错误

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