网络

查询我的 IP

0次调用
2 积分/次

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

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

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

功能概述

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

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

查询参数

source
string可选

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

响应

200 / 请求成功

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

JSON
{
  // 你的公网IP地址
  "ip": "117.182.103.101",
  // 地理位置,格式:国家 省份 城市
  "region": "中国 广西 南宁市",
  // 运营商名称
  "isp": "China Mobile Communications Group Co., Ltd.",
  // 归属机构
  "llc": "移动",
  // 自治系统编号
  "asn": "AS9808",
  // 纬度
  "latitude": 22.8111,
  // 经度
  "longitude": 108.3168,
  // IP段起始地址(标准查询)
  "beginip": "117.182.64.0",
  // IP段结束地址(标准查询)
  "endip": "117.182.127.255",
  // 行政区。仅 `source=commercial` 时可能返回。
  "district": "青秀区",
  // 时区名称。仅 `source=commercial` 时可能返回。
  "time_zone": "Asia/Shanghai"
}

400 / 错误的请求

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

JSON
{
  "code": "INVALID_STATE",
  "details": {},
  "message": "Could not determine client IP address."
}

500 / 服务器内部错误

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

JSON
{
  "code": "INTERNAL_SERVER_ERROR",
  "details": {},
  "message": "An internal error occurred while processing IP information."
}
免费查询我的IP地址API接口 - 在线获取本机公网IP | UAPI免费API平台 | UAPI