الاستعلام عن IPv6

الاستعلام نفسه الخاص بعناوين IPv4 ولكن لعناوين IPv6، مع البادئة المعلنة.

GEThttps://api.mygeocode.com/v1/ipv6

المعاملات

المعامل	النوع	الوصف
`ip`اختياري	سلسلة نصية	عنوان IPv6 بأي صيغة نصية. القيمة الافتراضية: العنوان الذي جاء منه الطلب.
`ips`اختياري	سلسلة نصية	عناوين مفصولة بفواصل، حتى 100. يُحتسب كل عنوان طلبًا واحدًا.
`lang`اختياري	سلسلة نصية	رمز ISO 639-1 للأسماء. القيمة الافتراضية `en`.
`key`اختياري	سلسلة نصية	مفتاح API، إذا لم يُرسل في ترويسة.

مثال

curlJavaScriptPython

$ 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، أو 4 عندما يُرسل عنوان IPv4 معيّن (::ffff:a.b.c.d)، وفي هذه الحالة تكون الإجابة هي بيانات IPv4.

أي من الإصدارين في استدعاء واحد

تقبل GET /v1/ip عنوان IPv4 أو IPv6 (أو لا شيء، للاستعلام عن المتصل) وتعيد السجل نفسه الذي تعيده نقاط النهاية الخاصة بكل إصدار. استخدمها عندما لا تعرف مسبقًا نوع العنوان الذي ستتلقاه.

ملاحظات

الصيغ المقبولة: المضغوطة (2001:db8::1)، والموسّعة، والمختلطة مع عنوان IPv4 مضمّن، والتي تحمل مؤشر منطقة (%eth0)، ويُحذف هذا المؤشر.
الاستدعاء دون ip عبر اتصال IPv4 يعيد نتيجة IPv4 بدلًا من خطأ، لذا يعمل استدعاء واحد للحالتين.

الأخطاء

400 invalid_request عندما لا يكون ip عنوان IPv6 صالحًا، أو عندما يحتوي ips على أكثر من 100 إدخال.