IPv6 查询
针对 IPv6 地址的查询,与 IPv4 查询相同,另外还提供所宣告的前缀。
GEThttps://api.mygeocode.com/v1/ipv6
参数
| 参数 | 类型 | 说明 |
|---|---|---|
ip可选 | 字符串 | 任何文本形式的 IPv6 地址。默认:发出请求的地址。 |
ips可选 | 字符串 | 以逗号分隔的地址,最多 100 个。每个地址计为一次请求。 |
lang可选 | 字符串 | 名称所用的 ISO 639-1 代码。默认为 en。 |
key可选 | 字符串 | API 密钥(如果未通过请求头发送)。 |
示例
$ curl -H "X-API-Key: YOUR_KEY" "https://api.mygeocode.com/v1/ipv6?ip=2606:4700:4700::1111"const url = new URL("https://api.mygeocode.com/v1/ipv6");
url.searchParams.set("ip", "2606:4700:4700::1111");
const geo = await (await fetch(url, { headers: { "X-API-Key": "YOUR_KEY" } })).json();
console.log(geo.prefix, geo.country_code);import requests
geo = requests.get("https://api.mygeocode.com/v1/ipv6", params={"ip": "2606:4700:4700::1111"}, headers={"X-API-Key": "YOUR_KEY"}, timeout=5).json()
print(geo["prefix"], geo["country_code"])响应
{
"status": "ok",
"ip": "2001:4860:4860::8888",
"version": 6,
"found": true,
"prefix": "2001:4860:4840::/42",
"country": "United States",
"country_code": "US",
"continent": "North America",
"continent_code": "NA",
"region": "California",
"region_code": null,
"city": "Mountain View",
"postcode": "94040",
"lat": 37.38605,
"lon": -122.08385,
"timezone": "America/Los_Angeles",
"utc_offset": "-07:00",
"utc_offset_seconds": -25200,
"is_eu": false,
"asn": 15169,
"as_name": "Google LLC",
"org": "Google LLC",
"usage_type": "Content",
"registry": "arin",
"allocated": "2000-03-30",
"tags": ["a10k", "anycast", "cdn", "icrit", "vpn", "vpsh"],
"is_anycast": false,
"is_satellite": false,
"is_datacenter": true,
"is_proxy": false,
"is_vpn_provider": true,
"is_tor": false,
"is_private": false,
"abuse_email": "network-abuse@google.com",
"threat": {
"listed": false,
"score": 0,
"source_count": 0,
"categories": [],
"is_tor": false,
"is_tor_exit": false,
"is_bogon": false,
"listings": []
},
"updated_at": "2026-09-18 09:28:30"
}响应字段
与 IPv4 查询的字段相同。prefix 是覆盖该地址的 IPv6 网络,version 为 6;如果发送的是 IPv4 映射地址(::ffff:a.b.c.d),则为 4,此时返回的是 IPv4 数据。
一次调用支持两种版本
GET /v1/ip 接受 IPv4 或 IPv6 地址(或不提供地址,以查询调用方),并返回与各版本专用端点相同的记录。当您事先不知道会收到哪种地址时使用它。
注意事项
- 接受的形式:压缩形式(
2001:db8::1)、完整形式、嵌入 IPv4 的混合形式,以及带区域索引(%eth0)的形式,区域索引会被去除。 - 通过 IPv4 连接不带
ip调用时,会返回 IPv4 结果而不是错误,因此一次调用即可同时适用于两者。
错误
当 ip 不是有效的 IPv6 地址,或 ips 超过 100 条时,返回 400 invalid_request。