Librerie client

Trova il codice sorgente e le istruzioni di configurazione del client per il tuo linguaggio.

Scegli il tuo linguaggio

Installa un client, esegui una ricerca e leggi i campi della risposta.

Il selettore del linguaggio richiede JavaScript. Tutti i repository dei client sono disponibili qui sotto.

TypeScript / JavaScript SDK

TypeScript / JavaScript

enrichip

Esecuzione verificata

Requisiti: Moduli ES · verificato su Node 26
Versione del pacchetto: 1.0.1

Installa

Terminale

npm install enrichip@1.0.1

Cerca un solo IP

node lookup.mjs

lookup.mjs

import { queryIP } from "enrichip";

const info = await queryIP("1.1.1.1");
console.log(JSON.stringify(info, null, 2));

Comportamento del client

Questo esempio usa il pacchetto npm pubblicato. L’argomento IP accetta una stringa, incluso IPv6 in forma compressa; il codice HEAD del repository usa una validazione più restrittiva.
Il client non espone un timeout per richiesta. Usa gli esempi HTTP quando devi controllare direttamente le impostazioni della richiesta.

Python

ipapi-py

Esecuzione verificata

Requisiti: Verificato su Python 3.13 · Pydantic 2
Revisione del sorgente: 9bd6552

Installa

Terminale

git clone https://github.com/ipqwery/ipapi-py.git
cd ipapi-py
git checkout 9bd655266582ec70d90d01296aa92784da5a27a5
python -m pip install "httpx==0.28.1" "pydantic>=2,<3"

Cerca un solo IP

python lookup.py

lookup.py

from ipapi.client import IPAPIClient

client = IPAPIClient()
try:
    info = client.query_ip("1.1.1.1")
    print(info.model_dump_json(indent=2))
finally:
    client.client.close()

Comportamento del client

Esegui lookup.py dalla copia locale del sorgente. La distribuzione pubblicata ipcore 0.1.2 contiene i metadati del pacchetto, ma non un modulo ipapi importabile; questa configurazione usa quindi il repository alla revisione fissata.
Il client usa il metodo deprecato parse_raw di Pydantic. Chiudi il suo client HTTP dopo l’uso; il wrapper non dispone di un gestore di contesto.

github.com/ipqwery/ipapi-go

Esecuzione verificata

Requisiti: Go 1.24.2 o successivo
Revisione del sorgente: fc7efc4

Installa

Terminale

go get github.com/ipqwery/ipapi-go@fc7efc494870418b9f1143f642aba8f5802ebf9f

Cerca un solo IP

go run .

main.go

package main

import (
    "fmt"
    "log"
    ipapi "github.com/ipqwery/ipapi-go"
)

func main() {
    info, err := ipapi.QueryIP("1.1.1.1")
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(info.IP)
    if info.ISP != nil {
        fmt.Println(info.ISP.ASN)
    }
}

Comportamento del client

Esegui il comando di installazione all’interno di un modulo Go. QueryIP restituisce un valore IPInfo annidato e un errore per le risposte HTTP non riuscite.
Il client non ha un timeout per chiamata. I tag omitempty omettono i valori false e zero se serializzi nuovamente il risultato; i valori decodificati vengono conservati.

Rust

ipapi

Esecuzione verificata

Requisiti: Edizione Rust 2021 · Tokio
Revisione del sorgente: 2313f1f

Installa

Terminale

cargo add ipapi --git https://github.com/ipqwery/ipapi-rust --rev 2313f1f6028803d5fcffc3332bc3cfda8a61df7f
cargo add tokio --features macros,rt-multi-thread,time

Cerca un solo IP

cargo run

src/main.rs

use std::time::Duration;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let info = tokio::time::timeout(
        Duration::from_secs(5),
        ipapi::query_ip("1.1.1.1"),
    ).await??;
    println!("{}", info.ip);
    if let Some(isp) = info.isp {
        println!("{:?}", isp.asn);
    }
    Ok(())
}

Comportamento del client

Installa la revisione sorgente fissata in un progetto Cargo; la versione documentata su crates.io non è disponibile. L’esempio limita la ricerca con un timeout Tokio di cinque secondi.
I campi annidati facoltativi usano Option. Il client decodifica la risposta senza verificarne prima lo stato HTTP; consulta la documentazione HTTP per gestire le risposte di errore.

Java

ipapi-java

Esempio sorgente

Requisiti: JDK 21 · wrapper Gradle
Revisione del sorgente: 5e303a5

Installa

Terminale

git clone https://github.com/ipqwery/ipapi-java.git
cd ipapi-java
git checkout 5e303a5dd2a373ae5b56a1f53139d8b8ca7f6761
./gradlew :app:build

Cerca un solo IP

Lookup.java

import ipapi.java.Ipapi;
import ipapi.java.IPInfo;

public class Lookup {
    public static void main(String[] args) throws Exception {
        IPInfo info = Ipapi.queryIp("1.1.1.1");
        System.out.println(info.getIp());
        if (info.getIsp() != null) {
            System.out.println(info.getIsp().getAsn());
        }
    }
}

Comportamento del client

Compila il sorgente alla revisione fissata con JDK 21. Questo esempio va inserito in un progetto che usa la libreria compilata nel classpath; qui non è stato verificato in esecuzione.
Il sorgente usa metodi statici in ipapi.java, senza chiave API. Il namespace io.ipapi e il costruttore con chiave API del README non corrispondono a questa revisione. Lo stato HTTP non viene verificato prima della decodifica.

C++

ipapi-cpp

Aggiornamento necessario

Requisiti: C++20 · CMake · libcurl
Revisione del sorgente: a5ae87c

Installa

Questa revisione del sorgente richiede un aggiornamento prima dell’uso.

Esamina il sorgente C++

Cerca un solo IP

Usa una richiesta HTTP standard

Il callback e la mappatura dei rischi C++ attuali richiedono correzioni. Una richiesta HTTP nativa restituisce la risposta completa dell’API.

Consulta l’endpoint HTTPS

Comportamento del client

Il client attuale interpreta ogni blocco di risposta libcurl come un documento JSON completo. Una risposta suddivisa in più blocchi potrebbe non essere decodificata correttamente.
La mappatura dei rischi lascia is_datacenter e risk_score non impostati. Il callback del proprio IP usa inoltre un tipo di risultato diverso da quello del chiamante. Usa una richiesta HTTP standard finché questi percorsi non vengono corretti.

ipapi

Esempio sorgente

Requisiti: R 4.1 o successivo
Revisione del sorgente: 79cd732

Installa

Console R

install.packages("remotes")
remotes::install_github("ipqwery/ipapi-r@79cd73249bd1f8fa41d950bc37ba5b9f6ee6d2d9")

Cerca un solo IP

Rscript lookup.R

lookup.R

library(ipapi)

info <- query_ips("1.1.1.1")
print(info[, c("ip", "asn", "country_code")])

Comportamento del client

Passa un indirizzo a query_ips. Un vettore con più indirizzi usa il percorso multiplo precedente, rifiutato dall’API.
Il risultato è un data frame con colonne appiattite. Questo esempio basato sulla revisione sorgente fissata non è stato verificato qui in esecuzione.

.NET

IpApi

Esecuzione verificata

Requisiti: .NET 9+ · verificato su .NET 10
Versione del pacchetto: 2024.12.23.223133

Installa

Terminale

dotnet add package IpApi --version 2024.12.23.223133

Cerca un solo IP

dotnet run

Program.cs

using IpApi;
using Microsoft.Extensions.DependencyInjection;
using System.Text.Json;

var services = new ServiceCollection();
services.AddIpApiClient();
using var provider = services.BuildServiceProvider();
var client = provider.GetRequiredService<IIApiClient>();
using var timeout = new CancellationTokenSource(TimeSpan.FromSeconds(5));
var info = await client.QueryIpAsync("1.1.1.1", timeout.Token);
if (info is null) throw new InvalidOperationException("Empty IP response");
Console.WriteLine(JsonSerializer.Serialize(info));

Comportamento del client

Esegui il codice in un progetto console .NET. L’interfaccia registrata è IIApiClient, con due caratteri I iniziali; il nome IIpApiClient nel README è diverso.
La risposta usa oggetti annidati Isp, Location e Risk. Passa un token di annullamento per limitare la richiesta. Il metodo precedente per più IP non è supportato dall’API.

Prima dell’integrazione

Richieste per un singolo IP: Usa un indirizzo per ricerca. Alcuni client espongono ancora metodi multipli; l’API rifiuta le richieste multiple. Leggi le regole sulle ricerche multiple
Risposte per il proprio IP: L’endpoint radice restituisce per impostazione predefinita l’IP pubblico del processo che si connette come testo. Per una risposta JSON completa del proprio IP, usa gli esempi HTTP
Ambito della verifica: Esecuzione verificata significa che il pacchetto o la revisione mostrati sono stati eseguiti per ricerche su singoli IP. Gli esempi sorgente sono stati confrontati con il codice, ma non eseguiti. Una revisione del sorgente può differire da un pacchetto pubblicato.

Preferisci HTTP nativo?Copia una richiesta con timeout e gestione degli errori HTTP.