Dokumentaatio — IPRapid

API

HTTP- ja JSON-API

Ei tunnistautumista

Keskeiset endpointit eivät vaadi tiliä tai evästettä. Dynaamiset vastaukset käyttävät Cache-Control: no-store -asetusta ja pyyntörajoitusotsakkeita.

API v1

Vakaa JSON

Versioitu snake_case-JSON vakaalla sopimuksella omalle ja kohde-IP:lle.

GET/api/v1/self

Nykyisen IP:n rakenteinen tulos verkko-, sijainti- ja ASN-kenttineen.

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

GET/api/v1/lookup/{ip}

Vahvistetun IPv4- tai IPv6-osoitteen rakenteinen haku.

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

Yhteensopivuus

Polku	Vastaus
`GET /`	Sisältöneuvottelua käyttävä juuri: JSON CLI:lle ja /:lle, yksi IP text/plainille ja SSR-HTML nimenomaiselle text/html-pyynnölle.
`GET /json`	Nykyisen IP:n rakenteinen tulos verkko-, sijainti- ja ASN-kenttineen.
`GET /json/{ip}`	Vahvistetun IPv4- tai IPv6-osoitteen rakenteinen haku.
`GET /ip/{ip}`	Normalisoitu kohde-IP ohjelmille; noindex-sivu vain nimenomaisella HTML-pyynnöllä.

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

Pääte

TEXT / ANSI

Polku	Vastaus
`GET /ip`	Normalisoitu nykyinen IP ja yksi rivinvaihto.
`GET /info[/{ip}]`	Yksityiskohtainen UTF-8-teksti vakioiduilla nimikkeillä ja järjestyksellä ilman ANSI-ohjausmerkkejä.
`GET /ansi[/{ip}]`	/info-näkymä erikseen käyttöön otetuilla sallituilla SGR-väreillä.
`GET /field/{field}[/{ip}]`	Yksi sallittu arvo ja rivinvaihto; 204 jos arvo puuttuu.

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"
}

Menetelmä ja signaalien rajat

Palvelu pitää palvelimen havaitsemat verkkotiedot, paikalliset sijaintitiedot ja selaimen signaalit erillään, jotta eri lähteitä ei sekoiteta.

Näytetty julkinen IP on osoite, jonka palvelu havaitsi tässä HTTP-yhteydessä.
Maa, alue, kaupunki, aikavyöhyke, koordinaatit, ASN ja organisaatio tulevat paikallisesta aineistosta.
WebRTC-, DNS-, kieli-, aikavyöhyke- ja IPv6-testit ovat selaimen itsenäisiä havaintoja.
Ei saatavilla, tuntematon, ei havaintoa ja poikkeama ovat eri tiloja.

Tarkkuus ja ajantasaisuus

IP-paikannus kuvaa verkko-osoitteen jakoa, ei laitetta tai kotitaloutta. Kaupunki ja koordinaatit voivat olla kaukana; tarkkuussäde on arvio, ei takuu.

Tietosuoja ja säilytys

Haku ei tallenna raakoja IP-osoitteita, URI-tietoja, otsakkeita tai sormenjälkiä PostgreSQL-koosteisiin. Allekirjoitetut linkit sisältävät vain rajatut tilat, vanhenevat 24 tunnissa eikä niitä tallenneta tietueina.

Usein kysytyt kysymykset

Onko näytetty kaupunki tarkka sijaintini?

Ei. IP-paikannus on likimääräinen verkkotason arvio. Käytä tarkkuussädettä, äläkä pidä koordinaatteja tarkkana osoitteena.

Tallentaako palvelu IP-hakuni tietokantaan?

Sovellus ei tallenna raakoja IP-osoitteita käyttökoosteisiin. Rajoitetut verkkolokit käsitellään erikseen.

Miksi IPv6 voi olla tuntematon eikä käytettävissä olematon?

Määrittämätön, estynyt tai epäselvä testi ei todista IPv6:n puuttumista; tila pysyy tuntemattomana selkeään tulokseen asti.

Mitä jaettu diagnostiikkalinkki sisältää?

Vain rajatut tilat, luonti- ja vanhenemisaika sekä allekirjoitus; ei IP:tä, koordinaatteja tai DNS-selvittimen osoitetta.