IP-geolokációs API-dokumentáció

Ingyenes JSON API IP-geolokációhoz, ASN- és kockázati adatokhoz. IPv4 és IPv6, HTTPS, engedélyezett CORS.

Ingyenes API-kulcs igénylése OpenAPI-specifikáció

Gyors kezdés

A kipróbáláshoz nem kell regisztrálni. Hívja meg az alábbi végpontot kulcs nélkül, és megkapja saját IP-címe adatait (napi 100 kérésre korlátozva).

curl https://iplookinfo.com/json

Hitelesítés

Hozzon létre egy ingyenes API-kulcsot a vezérlőpulton, és küldje el az Authorization fejlécben. Gyors tesztekhez a token lekérdezési paraméter is működik, de éles környezetben kerülje, mert az URL-ek naplókba kerülnek.

Authorization: Bearer ipl_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Végpontok

GET/api/v1/{ip}: Bármely IPv4- vagy IPv6-cím lekérdezése.
GET/api/v1/me: A hívó saját IP-címének lekérdezése. A /json címen is elérhető.
POST/api/v1/batch: Legfeljebb 10 000 IP-cím lekérdezése egyetlen kérésben (fizetős csomagok). Minden IP-cím egy kérésnek számít.

Lekérdezési paraméterek

lang — A helynevek nyelve: en, zh, es, pt, ru, ja. Alapértelmezés: en.

Válasz

A risk objektum csak a Pro és Business csomagokban szerepel.

{
  "ip": "8.8.8.8",
  "version": "IPv4",
  "type": "unicast",
  "bogon": false,
  "network": "8.8.8.0/24",
  "continent": { "code": "NA", "name": "North America" },
  "country": { "code": "US", "name": "United States", "is_eu": false },
  "region": null,
  "city": null,
  "postal": null,
  "location": { "latitude": 37.751, "longitude": -97.822, "accuracy_radius_km": 1000, "time_zone": "America/Chicago" },
  "asn": { "asn": 15169, "name": "Google LLC", "domain": "google.com", "route": "8.8.8.0/24" },
  "isp": { "name": "Google", "organization": "Google", "is_mobile": false, "mobile_country_code": null, "mobile_network_code": null },
  "risk": { "score": 60, "is_tor": false, "is_vpn": false, "is_datacenter": true, "provider": "Google Cloud" }
}

Sebességkorlátok és hibák

Minden válasz tartalmazza az X-RateLimit-Limit, X-RateLimit-Remaining és X-RateLimit-Reset fejléceket. A kvóták 00:00 UTC-kor nullázódnak.

A hibák egységes JSON formátumot használnak HTTP-állapotkóddal:

HTTP/1.1 429 Too Many Requests

{ "error": { "code": "quota_exceeded", "message": "..." } }

400 invalid_ip / bad_request
401 invalid_key
403 plan_required
413 too_many
429 rate_limited / quota_exceeded

Túllépés

A fizetős csomagok a vezérlőpulton bekapcsolhatják a túllépést. Ekkor a napi kvótán felüli kéréseket is kiszolgáljuk, és 1000-enként számlázzuk, az Ön által választott havi költségkeretig. Az ilyen válaszok X-Overage-Units fejlécet tartalmaznak.

Kódpéldák

cURL

curl -H "Authorization: Bearer $IPLOOKINFO_KEY" https://iplookinfo.com/api/v1/8.8.8.8

# Batch (paid plans)
curl -X POST -H "Authorization: Bearer $IPLOOKINFO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ips":["8.8.8.8","1.1.1.1"]}' https://iplookinfo.com/api/v1/batch

JavaScript

const res = await fetch("https://iplookinfo.com/api/v1/8.8.8.8", {
  headers: { Authorization: `Bearer ${process.env.IPLOOKINFO_KEY}` },
});
if (!res.ok) throw new Error((await res.json()).error.message);
const data = await res.json();
console.log(data.country?.code, data.city);

Python

import os, requests

r = requests.get(
    "https://iplookinfo.com/api/v1/8.8.8.8",
    headers={"Authorization": f"Bearer {os.environ['IPLOOKINFO_KEY']}"},
    timeout=5,
)
r.raise_for_status()
data = r.json()
print(data["country"]["code"], data["asn"]["name"])

PHP

$ctx = stream_context_create(["http" => [
    "header" => "Authorization: Bearer " . getenv("IPLOOKINFO_KEY"),
]]);
$data = json_decode(file_get_contents("https://iplookinfo.com/api/v1/8.8.8.8", false, $ctx), true);
echo $data["country"]["code"];

Go

req, _ := http.NewRequest("GET", "https://iplookinfo.com/api/v1/8.8.8.8", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("IPLOOKINFO_KEY"))
resp, err := http.DefaultClient.Do(req)
if err != nil { log.Fatal(err) }
defer resp.Body.Close()
var data map[string]any
json.NewDecoder(resp.Body).Decode(&data)