Documentazione API
API REST pubblica per geolocalizzazione IP, strumenti di rete e verifica della sicurezza.
https://mon-ip.devChiave API
L'API è accessibile pubblicamente senza autenticazione. Per limiti più alti, crea un account e genera una chiave API dalla tua dashboard. Apri la dashboard →
Trasmetti la tua chiave tramite l'header Authorization:
Rate limiting
Le richieste sono limitate in base al tuo livello di accesso. In caso di superamento, l'API restituisce un errore 429 Too Many Requests.
Ogni risposta include header per monitorare il tuo consumo:
X-RateLimit-LimitNumero massimo di richieste consentite all'oraX-RateLimit-RemainingRichieste rimanenti nella finestra correnteX-RateLimit-ResetTimestamp UNIX di reset del contatoreCodici di errore
In caso di errore, la risposta contiene un campo error con un messaggio descrittivo.
Terminale (curl)
Senza chiave né parametri: interroga direttamente la radice del sito da curl, wget, HTTPie o PowerShell. Risposte non memorizzate in cache, CORS consentito.
/ Restituisce il tuo indirizzo IP pubblico in testo semplice, seguito da un a capo, quando la richiesta proviene da un client a riga di comando (curl, wget, HTTPie, PowerShell…). Il percorso /ip restituisce la stessa risposta da qualsiasi client.
/json Geolocalizzazione e informazioni di rete del tuo IP, in JSON indentato (leggibile direttamente nel terminale).
ipstringIndirizzo IP analizzatoipTypestringVersione: IPv4 o IPv6ipClassstringClasse di IP (A, B, C)hostnamestringReverse DNScountrystringPaesecountryCodestringCodice paese ISO 3166-1 (2 lettere)citystringCittàcontinentstringContinentepostalCodestringCodice postale (se noto)latitudenumberLatitudine approssimativalongitudenumberLongitudine approssimativatimezonestringFuso orario (IANA)providerstringProvider o operatoreasnnumberNumero di sistema autonomo (AS)/{ip}/json Le stesse informazioni per qualsiasi indirizzo IPv4 o IPv6 indicato nel percorso. I campi assenti non vengono restituiti.
iprichiestoIndirizzo IPv4 o IPv6 da analizzare, nel percorso (es.: 8.8.8.8)IP e Geolocalizzazione
/api/v1/json Restituisce le informazioni di geolocalizzazione, ISP e sicurezza dell'IP del client.
ipstringIndirizzo IPv4ipv6stringIndirizzo IPv6 (se disponibile)hostnamestringReverse DNStypestringTipo di IP (Residential, Business, ecc.)classstringClasse di IP (A, B, C)locationobjectcountry, countryCode, city, continent, latitude, longitude, timezone, postalCodenetworkobjectprovider, asnsecurityobjectIndicatori di sicurezza (proxy, VPN, Tor, ecc.)/api/v1/ipv6 Rileva se il client si connette tramite IPv4 o IPv6.
ipstringIndirizzo IP del clientis_ipv4booleantrue se IPv4is_ipv6booleantrue se IPv6 nativoprotocolstring"IPv4" o "IPv6"timestampstringTimestamp ISO 8601DNS e Domini
/api/v1/dns Esegue una risoluzione DNS per un tipo di record specificato.
hostrichiestoNome di dominio (es: google.com)record_typerichiestoTipo: A, AAAA, MX, NS, TXT, CNAME, SOA, PTR, SRVhoststringDominio interrogatorecordsarrayElenco di record: record_type, value, ttl/api/v1/whois Restituisce le informazioni WHOIS di un dominio o di un IP.
targetrichiestoDominio o IP (es: google.com)targetstringObiettivo interrogatorawstringRisposta WHOIS grezzaparsedobjectdomain_name, registrar, creation_date, expiration_date, name_servers, status, dnsseccachedbooleantrue se il risultato proviene dalla cache/api/v1/ssl Verifica il certificato SSL/TLS di un dominio connettendosi alla porta 443.
hostrichiestoNome di dominio (es: google.com)hoststringDominio testatovalidbooleantrue se il certificato è validodays_remainingnumberGiorni alla scadenzasubjectstringSoggetto (CN)issuerstringEmittente (CN)issuer_orgstringOrganizzazione dell'emittentevalid_fromstringData di inizio (ISO 8601)valid_tostringData di scadenza (ISO 8601)serialstringNumero di seriefingerprintstringImpronta SHA-256protocolstringProtocollo TLS (es: TLSv1.3)bitsnumber | nullDimensione chiave in bitalt_namesstring[]Nomi alternativi (SAN)Sicurezza
/api/v1/blacklist Verifica se un indirizzo IPv4 è elencato in 8 blacklist DNS.
iprichiestoIndirizzo IPv4 (es: 8.8.8.8)ipstringIP testatototalnumberNumero di liste testatelistednumberNumero di liste in cui appare l'IPcleanbooleantrue se l'IP non è in nessuna listaresultsarrayDettaglio per lista: name, zone, listedRete
/api/v1/ping SSEInvia pacchetti ICMP e restituisce i risultati in tempo reale tramite Server-Sent Events.
hostrichiestoHost o IP (es: 8.8.8.8)countopzionaleNumero di pacchetti (predefinito: 4)starthost, resolved_ipreplyseq, ip, time_ms, ttltimeoutseqdonealive, packets_sent, packets_received, packet_loss, min_ms, avg_ms, max_mserrormessage/api/v1/traceroute SSETraccia il percorso di rete verso un host in tempo reale tramite Server-Sent Events.
hostrichiestoHost o IP (es: google.com)starthost, resolved_iphophop, ip, hostname, rtt_msdonetotal_hops, reachederrormessageEventSource / curl -NOttieni il tuo IP dal terminale
Usa la nostra API o il comando curl per integrare mon-ip.dev nei tuoi script.