Dokumentacja — IPRapid

API

API HTTP i JSON

Bez uwierzytelniania

Główne endpointy nie wymagają konta ani cookie. Odpowiedzi dynamiczne używają Cache-Control: no-store i nagłówków limitu żądań.

API v1

Stabilny JSON

Wersjonowany JSON snake_case ze stabilnym kontraktem dla własnego i wskazanego IP.

GET/api/v1/self

Ustrukturyzowany wynik bieżącego IP z polami sieci, lokalizacji i ASN.

curl --fail --silent --show-error https://iprapid.com/api/v1/self

GET/api/v1/lookup/{ip}

Ustrukturyzowane wyszukiwanie zweryfikowanego adresu IPv4 lub IPv6.

curl --fail --silent --show-error https://iprapid.com/api/v1/lookup/8.8.8.8

GET/api/v1/meta

schema_version · capabilities · fields

curl --fail --silent --show-error https://iprapid.com/api/v1/meta

JSON

Zgodność

Ścieżka	Odpowiedź
`GET /`	Ścieżka główna z negocjacją treści: JSON dla CLI i /, jeden IP dla text/plain oraz SSR HTML przy jawnym żądaniu text/html.
`GET /json`	Ustrukturyzowany wynik bieżącego IP z polami sieci, lokalizacji i ASN.
`GET /json/{ip}`	Ustrukturyzowane wyszukiwanie zweryfikowanego adresu IPv4 lub IPv6.
`GET /ip/{ip}`	Znormalizowany docelowy IP dla programów; strona noindex tylko przy jawnym żądaniu HTML.

curl -sS https://iprapid.com/json
curl -sS https://iprapid.com/json/8.8.8.8

Terminal

TEXT / ANSI

Ścieżka	Odpowiedź
`GET /ip`	Znormalizowany bieżący IP i jeden znak nowego wiersza.
`GET /info[/{ip}]`	Szczegółowy tekst UTF-8 ze stałymi etykietami i kolejnością, bez kodów sterujących ANSI.
`GET /ansi[/{ip}]`	Widok /info z jawnie włączonymi dozwolonymi kolorami SGR.
`GET /field/{field}[/{ip}]`	Jedna dozwolona wartość i nowy wiersz; 204, gdy brak danych.

curl iprapid.com
curl -4 iprapid.com
curl -6 iprapid.com

curl.exe iprapid.com
curl.exe -4 iprapid.com
curl.exe -6 iprapid.com

API v1 · JSON

APPLICATION/JSON

{
  "schema_version": "1",
  "query": {
    "type": "lookup",
    "ip": "8.8.8.8",
    "ip_version": 4
  },
  "network": {
    "asn": 15169,
    "as_organization": "Google LLC"
  },
  "location": {
    "continent_code": "NA",
    "country_code": "US",
    "country": "United States",
    "region_code": null,
    "region": null,
    "city": null,
    "postal_code": null,
    "timezone": "America/Chicago",
    "coordinates": {
      "latitude": 37.751,
      "longitude": -97.822,
      "accuracy_radius_km": 1000
    }
  },
  "data": {
    "status": "available",
    "built_at": "2026-03-03T08:15:43Z"
  },
  "observed_at": "2026-07-25T12:23:07Z"
}

Metodyka i granice sygnałów

Usługa rozdziela dane sieciowe obserwowane przez serwer, lokalne dane geograficzne i sygnały przeglądarki, aby nie przedstawiać jednego źródła jako innego.

Wyświetlany publiczny IP to adres zaobserwowany przez usługę dla tego połączenia HTTP.
Kraj, region, miasto, strefa czasowa, współrzędne, ASN i organizacja pochodzą z lokalnego zbioru danych.
Testy WebRTC, DNS, języka, strefy czasowej i IPv6 są niezależnymi obserwacjami w przeglądarce.
Niedostępne, nieznane, brak obserwacji i niezgodność to różne stany.

Dokładność i aktualność

Geolokalizacja IP opisuje przydział sieci, a nie urządzenie lub gospodarstwo domowe. Miasto i współrzędne mogą być odległe; promień dokładności jest szacunkiem, nie gwarancją.

Prywatność i przechowywanie

Wyszukiwanie nie zapisuje surowych IP, URI, nagłówków ani odcisków w agregatach PostgreSQL. Podpisane linki zawierają tylko ograniczone stany, wygasają po 24 godzinach i nie są zapisywane jako rekordy.

Częste pytania

Czy wyświetlane miasto to moja dokładna lokalizacja?

Nie. Geolokalizacja IP jest przybliżeniem na poziomie sieci. Uwzględnij promień dokładności i nie traktuj współrzędnych jako dokładnego adresu.

Czy usługa zapisuje moje wyszukiwanie IP w bazie danych?

Aplikacja nie przechowuje surowych adresów IP w agregatach użycia. Ograniczone logi dostępu WWW są obsługiwane osobno.

Dlaczego stan IPv6 może być nieznany zamiast niedostępny?

Nieskonfigurowany, zablokowany lub niejednoznaczny test nie dowodzi braku IPv6; stan pozostaje nieznany do uzyskania jasnego wyniku.

Co zawiera udostępniony link diagnostyczny?

Tylko ograniczone wartości stanu, czas wydania i wygaśnięcia oraz podpis; bez IP, współrzędnych i adresów resolverów DNS.