Нужен API-ключ?
Нет. GET на публичные HTTPS URL.
Публичный IP этого соединения или любой IPv4/IPv6 в стабильном JSON ipkit.v1. База https://ipkit.dev. Ключ не нужен.
IPKit работает на крае Cloudflare. HTML и JSON делят один pipeline. Страница описывает HTTP API как в коде. SLA нет; пользуйтесь разумно.
Скрипты вызывают JSON URL и ветвятся по HTTP-статусу и объекту ipkit.v1. Это не статья «какой у меня IP», не разбор hostname и пакета на /ip-lookup, не тест IPv6 на /ipv6 и не справочник номеров AS на /asn-lookup. Не снимайте поля с этих HTML-страниц. Отдельной HTML-страницы на каждый IP или ASN нет.
Три вызова, которые вкладка браузера прячет: hostname сведённый к ASN и организации, документационный адрес, который обязан завершиться ошибкой, и текущее соединение вместе с HTTP-статусом.
Hostname, затем ASN и организация
dns.quad9.net разрешается в публичный адрес и возвращается как ipkit.v1. jq оставляет IP, ASN, организацию и usage. Введённый hostname полем не является.
curl -sS 'https://ipkit.dev/api/ip/dns.quad9.net' | jq '{ip,asn:.network.asn,org:.network.organization,usage:.network.usage}'Документационный диапазон (ожидается 400)
203.0.113.10 — это TEST-NET-3 (RFC 5737). Ответ HTTP 400 с кодом RESERVED_IP. Этот 400 означает отказ, а не сбой API.
curl -sS -D - -o /tmp/ipkit-reserved.json --url https://ipkit.dev/203.0.113.10Текущий IP и код статуса
GET /api/my-ip всегда JSON для этого соединения. Фрагмент сохраняет тело и печатает HTTP-статус отдельно, чтобы 200 и 429 не считались одной нагрузкой.
code=$(curl -sS -o /tmp/ipkit.json -w '%{http_code}' https://ipkit.dev/api/my-ip)
jq '{ip,type,source}' /tmp/ipkit.json
printf 'HTTP %s\n' "$code"Всё на https://ipkit.dev. Пути чувствительны к регистру. IPv6 в URL иногда нужно экранировать.
Lookup routes accept GET, HEAD, and OPTIONS. HEAD returns the same status and headers with an empty body. POST and other methods are not part of the lookup API. Clients do not send an API key; arbitrary lookups still need the operator-configured IPREGISTRY_API_KEY Worker secret.
There is no plaintext-only route and no endpoint that returns a single field. Read ip from the ipkit.v1 object (for example jq -r .ip). Lookups of private, loopback, link-local, CGNAT, multicast, unspecified, documentation, and other reserved IPv4/IPv6 ranges (including IPv4-mapped IPv6 such as ::ffff:10.0.0.1) return 400 RESERVED_IP. Current-IP detection of this connection is not subject to that check.
Только / выбирает HTML или JSON. /{ip} и /api/* всегда отдают JSON.
Full nullable contract for parsers. The homepage mentions a shorter set of fields for people reading HTML; clients should use this list, including nulls and the difference between source=ipregistry and source=cloudflare. Successful lookups return Content-Type application/json; charset=utf-8, pretty-printed with two-space indent and a trailing newline. Field names stay in English. null means that value was not supplied. Locations are network estimates, not a street address or identity.
source is "ipregistry" when the configured intelligence provider succeeded. It is "cloudflare" when the record is built from Cloudflare request metadata (used for the current IP if the provider is missing or fails). Cloudflare metadata describes the connecting client only; it is never used as geolocation for a different target IP. Cloudflare-sourced records fill location.countryCode from request.cf.country or CF-IPCountry and location.country from that code when a name is known. Several network fields stay null, security flags are null, and security.risk is "unknown". If IPREGISTRY_API_KEY is unset, arbitrary lookups return 503 instead of guessing the caller’s country.
Illustrative ipkit.v1 object for 8.8.8.8. Values change with the address and data source; clients must tolerate nulls.
{
"schema": "ipkit.v1",
"ip": "8.8.8.8",
"type": "IPv4",
"source": "ipregistry",
"location": {
"continent": "North America",
"country": "United States",
"countryCode": "US",
"region": "California",
"regionCode": "CA",
"city": "Mountain View",
"postalCode": null,
"latitude": 37.386,
"longitude": -122.0838,
"timezone": "America/Los_Angeles"
},
"network": {
"asn": "AS15169",
"organization": "Google LLC",
"domain": "google.com",
"route": "8.8.8.0/24",
"usage": "hosting",
"carrier": null
},
"security": {
"proxy": false,
"vpn": false,
"tor": false,
"relay": false,
"cloud": true,
"threat": false,
"risk": "medium"
}
}Failures return JSON { "error": string, "code": string } with Cache-Control: no-store. error is a human-readable message; code is a stable machine token.
Каждый JSON-ответ (включая ошибки) содержит Access-Control-Allow-Origin: *. OPTIONS-preflight (204) на /, /{ip}, /api/my-ip и /api/ip/{ip} (GET, HEAD, OPTIONS; Max-Age 86400). HTML с / — не CORS JSON.
300 запросов за 60 секунд на IP клиента. SLA нет. Разумное использование: бесплатный публичный инструмент, не контрактный API.
Current-IP JSON (negotiated / and /api/my-ip) is Cache-Control: private, no-store so one client’s address is not reused for another. Specific-IP lookups (/{ip} and /api/ip/{ip}) are Cache-Control: public, max-age=300, s-maxage=3600, stale-while-revalidate=86400. Error responses are no-store. / JSON also varies on Accept and CF-Connecting-IP.
No authentication. HTTPS only. Parse schema and handle nulls and error objects.
Current public IP (curl)
curl https://ipkit.devLook up an address
curl https://ipkit.dev/8.8.8.8IPv6 in the path (quote colons)
curl "https://ipkit.dev/2001:4860:4860::8888"Always-JSON current IP
curl https://ipkit.dev/api/my-ipJavaScript fetch
const response = await fetch('https://ipkit.dev', {
headers: { Accept: 'application/json' },
});
const data = await response.json();
console.log(data.ip, data.location.countryCode);Python
import json, urllib.request
with urllib.request.urlopen('https://ipkit.dev') as response:
data = json.load(response)
print(data['ip'], data['location']['countryCode'])Shell one-liner (scripts / DDNS)
curl -sS https://ipkit.dev | jq -r .ipIPKit обрабатывает запрашиваемый адрес и обычные метаданные на крае Cloudflare. Прикладной базы IP посетителей нет. Геолокация — оценка сети. См. политику конфиденциальности.
Политика конфиденциальности · IP lookup · Тест IPv6 · ASN lookup
Нет. GET на публичные HTTPS URL.
Нет text/plain. Парсите JSON: curl -sS https://ipkit.dev | jq -r .ip
Accept содержит text/html. Используйте ?format=json или /api/my-ip.
Нет. /{ip} и /api/ip/{ip} отклоняют частные/зарезервированные диапазоны с 400 RESERVED_IP. GET / и /api/my-ip по-прежнему отдают клиента.
Сообщение «IP intelligence is not configured for arbitrary lookups.» значит, что на Cloudflare-аккаунте ipkit.dev нет Worker-секрета IPREGISTRY_API_KEY. Определение текущего IP работает.