Documentazione — IPRapid

API

API HTTP e JSON

Senza autenticazione

Gli endpoint principali non richiedono account né cookie. Le risposte dinamiche usano Cache-Control: no-store e intestazioni di limite richieste.

API v1

JSON stabile

JSON snake_case versionato per ricerche proprie e di destinazione con contratto di risposta stabile.

GET/api/v1/self

Risultato strutturato dell’IP corrente con campi di rete, posizione e ASN.

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

GET/api/v1/lookup/{ip}

Ricerca strutturata di un indirizzo IPv4 o IPv6 convalidato.

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

Compatibilità

Percorso	Risposta
`GET /`	Radice con negoziazione dei contenuti: JSON per CLI e /, un IP per text/plain e HTML SSR su richiesta esplicita di text/html.
`GET /json`	Risultato strutturato dell’IP corrente con campi di rete, posizione e ASN.
`GET /json/{ip}`	Ricerca strutturata di un indirizzo IPv4 o IPv6 convalidato.
`GET /ip/{ip}`	IP di destinazione normalizzato per i client automatici; pagina noindex solo per una richiesta HTML esplicita.

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

Terminale

TEXT / ANSI

Percorso	Risposta
`GET /ip`	IP corrente normalizzato seguito da un solo avanzamento riga.
`GET /info[/{ip}]`	Testo UTF-8 dettagliato, con etichette e ordine stabili e senza controlli ANSI.
`GET /ansi[/{ip}]`	Vista /info con colori SGR consentiti e attivati esplicitamente.
`GET /field/{field}[/{ip}]`	Un valore consentito seguito da un avanzamento riga; 204 se non disponibile.

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

Metodologia e limiti dei segnali

Il servizio separa i dati di rete osservati dal server, i dataset geografici locali e le evidenze del browser, senza presentare un segnale come un altro.

L’IP pubblico mostrato è l’indirizzo osservato dal servizio per questa connessione HTTP.
Paese, regione, città, fuso orario, coordinate, ASN e organizzazione provengono da un dataset locale.
I test WebRTC, DNS, lingua, fuso orario e IPv6 sono osservazioni indipendenti eseguite nel browser.
Non disponibile, sconosciuto, nessuna osservazione e mancata corrispondenza sono stati distinti.

Accuratezza e aggiornamento

La geolocalizzazione IP descrive un’assegnazione di rete, non un dispositivo o un’abitazione. Città e coordinate possono essere distanti; il raggio di precisione è una stima, non una garanzia.

Privacy e conservazione

La ricerca non salva IP grezzi, URI, intestazioni o impronte negli aggregati PostgreSQL. I link firmati contengono solo stati ridotti, scadono dopo 24 ore e non sono salvati come record.

Domande frequenti

La città mostrata è la mia posizione esatta?

No. La geolocalizzazione IP è una stima approssimativa a livello di rete. Considera il raggio di precisione e non usarla come indirizzo esatto.

Il servizio salva la mia ricerca IP nel database?

L’applicazione non salva indirizzi IP grezzi negli aggregati di utilizzo. I log web riservati sono gestiti separatamente.

Perché IPv6 può risultare sconosciuto anziché non disponibile?

Un test non configurato, bloccato o inconcludente non dimostra l’assenza di IPv6; lo stato resta sconosciuto fino a un risultato certo.

Cosa contiene un link diagnostico condiviso?

Solo stati ridotti, orari di emissione e scadenza e una firma; nessun IP, coordinata o indirizzo del resolver DNS.