Bibliothèques clientes

Retrouvez le code source et les instructions de configuration du client de votre langage.

Choisissez votre langage

Installez un client, effectuez une recherche et consultez les champs de la réponse.

Le sélecteur de langage nécessite JavaScript. Tous les dépôts clients sont disponibles ci-dessous.

TypeScript / JavaScript SDK

TypeScript / JavaScript

enrichip

Exécution vérifiée

Prérequis: Modules ES · vérifié avec Node 26
Version du paquet: 1.0.1

Installer

Terminal

npm install enrichip@1.0.1

Rechercher une seule 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));

Comportement du client

Cet exemple utilise le paquet npm publié. Son argument IP accepte une chaîne, y compris une IPv6 abrégée ; la révision HEAD du dépôt applique une validation plus stricte.
Le client n’expose pas de délai d’attente par requête. Utilisez les exemples HTTP si vous devez contrôler directement les paramètres des requêtes.

Python

ipapi-py

Exécution vérifiée

Prérequis: Vérifié avec Python 3.13 · Pydantic 2
Révision du code source: 9bd6552

Installer

Terminal

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"

Rechercher une seule 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()

Comportement du client

Exécutez lookup.py depuis le répertoire des sources extraites. La distribution publiée ipcore 0.1.2 contient les métadonnées du paquet, mais aucun module ipapi importable ; cette configuration utilise donc le dépôt à la révision fixée.
Le client utilise la méthode obsolète parse_raw de Pydantic. Fermez son client HTTP après utilisation ; le wrapper ne possède pas de gestionnaire de contexte.

github.com/ipqwery/ipapi-go

Exécution vérifiée

Prérequis: Go 1.24.2 ou version ultérieure
Révision du code source: fc7efc4

Installer

Terminal

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

Rechercher une seule 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)
    }
}

Comportement du client

Exécutez la commande d’installation dans un module Go. QueryIP renvoie une valeur IPInfo imbriquée et une erreur pour les réponses HTTP en échec.
Le client ne possède pas de délai d’attente par appel. Ses tags omitempty omettent les valeurs false et zéro si vous sérialisez à nouveau le résultat ; les valeurs décodées sont conservées.

Rust

ipapi

Exécution vérifiée

Prérequis: Édition Rust 2021 · Tokio
Révision du code source: 2313f1f

Installer

Terminal

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

Rechercher une seule 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(())
}

Comportement du client

Installez la révision source fixée dans un projet Cargo ; la version documentée sur crates.io est indisponible. L’exemple limite la recherche à cinq secondes avec un délai d’attente Tokio.
Les champs imbriqués facultatifs utilisent Option. Le client décode la réponse sans vérifier d’abord son statut HTTP ; consultez la référence HTTP pour gérer les réponses d’erreur.

Java

ipapi-java

Exemple source

Prérequis: JDK 21 · wrapper Gradle
Révision du code source: 5e303a5

Installer

Terminal

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

Rechercher une seule 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());
        }
    }
}

Comportement du client

Compilez la révision source fixée avec JDK 21. Cet exemple doit être utilisé dans un projet consommateur dont le classpath contient la bibliothèque compilée ; il n’a pas été vérifié à l’exécution ici.
Le code utilise des méthodes statiques dans ipapi.java, sans clé API. L’espace de noms io.ipapi et le constructeur avec clé API du README ne correspondent pas à cette révision. Le statut HTTP n’est pas vérifié avant décodage.

C++

ipapi-cpp

Mise à jour nécessaire

Prérequis: C++20 · CMake · libcurl
Révision du code source: a5ae87c

Installer

Cette révision du code source nécessite une mise à jour avant utilisation.

Examiner le code source C++

Rechercher une seule IP

Utilisez une requête HTTP standard

Le callback et le mappage des risques C++ actuels nécessitent des corrections. Une requête HTTP native renvoie la réponse complète de l’API.

Voir le point d’accès HTTPS

Comportement du client

Le client actuel analyse chaque bloc de réponse libcurl comme un document JSON complet. Une réponse répartie sur plusieurs blocs risque de ne pas être décodée correctement.
Le mappage des risques laisse is_datacenter et risk_score non renseignés. Le callback de sa propre IP utilise aussi un type de résultat différent de celui de son appelant. Utilisez une requête HTTP standard jusqu’à la correction de ces traitements.

ipapi

Exemple source

Prérequis: R 4.1 ou version ultérieure
Révision du code source: 79cd732

Installer

Console R

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

Rechercher une seule IP

Rscript lookup.R

lookup.R

library(ipapi)

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

Comportement du client

Passez une seule adresse à query_ips. Un vecteur contenant plusieurs adresses utilise l’ancien traitement groupé, rejeté par l’API.
Le résultat est un data frame aux colonnes aplaties. Cet exemple à révision source fixée n’a pas été vérifié à l’exécution ici.

.NET

IpApi

Exécution vérifiée

Prérequis: .NET 9+ · vérifié avec .NET 10
Version du paquet: 2024.12.23.223133

Installer

Terminal

dotnet add package IpApi --version 2024.12.23.223133

Rechercher une seule 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));

Comportement du client

Exécutez ce code dans un projet console .NET. L’interface enregistrée est IIApiClient, avec deux caractères I initiaux ; le nom IIpApiClient du README est différent.
La réponse utilise des objets imbriqués Isp, Location et Risk. Passez un jeton d’annulation pour limiter la requête. L’ancienne méthode multi-IP n’est pas prise en charge par l’API.

Avant l’intégration

Requêtes pour une seule IP: Utilisez une adresse par recherche. Certains clients exposent encore des méthodes groupées ; l’API rejette ces requêtes. Lire la politique de recherches groupées
Réponses pour sa propre IP: Le point d’accès racine renvoie par défaut l’IP publique du processus qui se connecte sous forme de texte. Pour une réponse JSON complète de sa propre IP, utilisez les exemples HTTP
Portée de la vérification: Exécution vérifiée signifie que le paquet ou la révision affichés ont été exécutés pour des recherches d’une seule IP. Les exemples source ont été examinés au regard du code, mais n’ont pas été exécutés. Une révision source peut différer d’un paquet publié.

Vous préférez le HTTP natif ?Copiez une requête avec délai d’attente et gestion des erreurs HTTP.