Bibliotecas cliente

Encuentra el código fuente y las instrucciones de configuración del cliente de tu lenguaje.

Elige tu lenguaje

Instala un cliente, consulta una dirección y lee los campos de la respuesta.

El selector de lenguaje necesita JavaScript. Todos los repositorios cliente están disponibles a continuación.

TypeScript / JavaScript SDK

TypeScript / JavaScript

enrichip

Probado en ejecución

Requisitos: Módulos ES · probado en Node 26
Versión del paquete: 1.0.1

Instalar

Terminal

npm install enrichip@1.0.1

Consultar una 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));

Comportamiento del cliente

Este ejemplo usa el paquete publicado en npm. Su argumento IP acepta una cadena, incluido IPv6 comprimido; la revisión HEAD del repositorio tiene un validador más estricto.
El cliente no expone un tiempo de espera por solicitud. Usa los ejemplos HTTP cuando necesites controlar directamente la configuración de la solicitud.

Python

ipapi-py

Probado en ejecución

Requisitos: Probado en Python 3.13 · Pydantic 2
Revisión del código fuente: 9bd6552

Instalar

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"

Consultar una 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()

Comportamiento del cliente

Ejecuta lookup.py desde la copia del repositorio fuente. La distribución publicada ipcore 0.1.2 contiene metadatos del paquete, pero no un módulo ipapi importable; esta configuración usa en su lugar el repositorio fijado a una revisión.
El cliente usa el método obsoleto parse_raw de Pydantic. Cierra el cliente HTTP después de usarlo; la clase cliente no implementa un gestor de contexto.

github.com/ipqwery/ipapi-go

Probado en ejecución

Requisitos: Go 1.24.2 o posterior
Revisión del código fuente: fc7efc4

Instalar

Terminal

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

Consultar una 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)
    }
}

Comportamiento del cliente

Ejecuta el comando de instalación dentro de un módulo Go. QueryIP devuelve un valor IPInfo anidado y un error para las respuestas HTTP no satisfactorias.
El cliente no tiene tiempo de espera por llamada. Si vuelves a serializar el resultado, sus etiquetas omitempty omiten los valores false y cero; los valores analizados se conservan.

Rust

ipapi

Probado en ejecución

Requisitos: Edición 2021 de Rust · Tokio
Revisión del código fuente: 2313f1f

Instalar

Terminal

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

Consultar una 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(())
}

Comportamiento del cliente

Instala la revisión fuente fijada en un proyecto Cargo; la versión documentada de crates.io no está disponible. El ejemplo limita la consulta con un tiempo de espera de Tokio de cinco segundos.
Los campos anidados opcionales usan Option. El cliente decodifica la respuesta sin comprobar antes su estado HTTP; consulta la referencia HTTP para gestionar las respuestas de error.

Java

ipapi-java

Ejemplo de código fuente

Requisitos: JDK 21 · wrapper de Gradle
Revisión del código fuente: 5e303a5

Instalar

Terminal

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

Consultar una 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());
        }
    }
}

Comportamiento del cliente

Compila la revisión fijada con JDK 21. Este ejemplo debe ir en un proyecto consumidor con la biblioteca compilada en su classpath; aquí no se ha probado en ejecución.
El código usa métodos estáticos en ipapi.java, sin clave de API. El espacio de nombres io.ipapi y el constructor con clave del README no coinciden con esta revisión. No se comprueba el estado HTTP antes de decodificar.

C++

ipapi-cpp

Requiere actualización

Requisitos: C++20 · CMake · libcurl
Revisión del código fuente: a5ae87c

Instalar

Esta revisión del código fuente necesita una actualización antes de utilizarse.

Inspeccionar el código C++

Consultar una IP

Usa una solicitud HTTP estándar

El callback y el mapeo de riesgo actuales de C++ necesitan correcciones. Una solicitud HTTP nativa devuelve la respuesta completa de la API.

Ver el endpoint HTTPS

Comportamiento del cliente

El cliente actual analiza cada fragmento de respuesta de libcurl como un documento JSON completo. Una respuesta dividida en varios fragmentos puede no decodificarse correctamente.
El mapeo de riesgo deja is_datacenter y risk_score sin asignar. El callback de la IP del cliente también usa un tipo de resultado distinto al de quien lo llama. Usa una solicitud HTTP estándar hasta que se corrijan estas rutas.

ipapi

Ejemplo de código fuente

Requisitos: R 4.1 o posterior
Revisión del código fuente: 79cd732

Instalar

Consola de R

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

Consultar una IP

Rscript lookup.R

lookup.R

library(ipapi)

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

Comportamiento del cliente

Pasa una dirección a query_ips. Un vector con varias direcciones utiliza la ruta masiva antigua, que la API rechaza.
El resultado es un data frame con columnas aplanadas. Este ejemplo con revisión fuente fijada no se ha probado aquí en ejecución.

.NET

IpApi

Probado en ejecución

Requisitos: .NET 9+ · probado en .NET 10
Versión del paquete: 2024.12.23.223133

Instalar

Terminal

dotnet add package IpApi --version 2024.12.23.223133

Consultar una 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));

Comportamiento del cliente

Ejecútalo en un proyecto de consola .NET. La interfaz registrada es IIApiClient, con dos caracteres I iniciales; el nombre IIpApiClient del README es distinto.
La respuesta usa objetos anidados Isp, Location y Risk. Pasa un token de cancelación para limitar la solicitud. La API no admite el antiguo método de múltiples IP.

Antes de integrar

Consultas de una sola IP: Usa una dirección por consulta. Algunos clientes aún exponen métodos masivos; la API rechaza las solicitudes masivas. Leer la política de consultas masivas
Respuestas de la IP del cliente: El endpoint raíz devuelve por defecto la IP pública del proceso que se conecta como texto. Para obtener la respuesta JSON completa de la IP del cliente, usa los ejemplos HTTP
Alcance de la verificación: Probado en ejecución significa que el paquete o la revisión mostrados se ejecutaron para consultas individuales. Los ejemplos de código fuente se revisaron con respecto al código, pero no se ejecutaron. Una revisión puede diferir del paquete publicado.

¿Prefieres HTTP nativo?Copia una solicitud con tiempo de espera y gestión de errores HTTP.