查询指定IP地址的归属信息
想知道一个IP地址来自地球的哪个角落?这个接口可以帮你定位它。你可以选择使用默认的GeoIP数据库,也可以指定 source=commercial
参数来查询更详细的商业级IP归属信息。
你需要查询的公网IP地址(支持IPv4和IPv6)。
查询的数据源。如果留空,将使用默认的数据库。如果设置为 commercial
,将调用商业级API,返回更详细的地理位置信息,但响应时间可能会稍长。
功能概述
提供一个公网IPv4或IPv6地址,我们会利用GeoIP数据库查询并返回它的地理位置(国家、省份、城市)、经纬度、以及所属的运营商(ISP)和自治系统(ASN)信息。这在网络安全分析、访问来源统计等领域非常有用。
当使用 source=commercial
参数时,接口将调用高性能商业API,提供更精确的市、区、运营商、时区、海拔等信息。请注意,商业查询的响应时间可能会稍长。
查询参数
你需要查询的公网IP地址(支持IPv4和IPv6)。
查询的数据源。如果留空,将使用默认的数据库。如果设置为 commercial
,将调用商业级API,返回更详细的地理位置信息,但响应时间可能会稍长。
响应
200 / 请求成功
查询成功!返回该IP地址的详细地理和网络信息。
示例 1:标准查询 (不带 source
参数)
请求: /api/v1/network/ipinfo?ip=120.24.0.0
响应:
示例 2:商业数据源查询 (source=commercial
)
请求: /api/v1/network/ipinfo?ip=120.24.0.0&source=commercial
响应:
400 / 错误的请求
IP地址参数无效。请检查 ip
参数是否提供,以及它是否是一个合法的公网IP地址。
404 / 未找到
信息未找到。这通常意味着你查询的是一个内网IP地址(如 192.168.x.x)或一个未分配的公网IP地址,我们的数据库中没有它的信息。
500 / 服务器内部错误
服务器内部错误。我们的GeoIP数据库查询服务可能遇到了问题。