OpenIPApi

SDKs oficiales de OpenIPApi

Descargue clientes oficiales ligeros para JavaScript, Python y PHP.

Todos los SDKs apuntan a la misma API REST en https://api.openipapi.com, se autentican con la cabecera X-API-Key y exponen los mismos métodos: lookup(ip), me(), batch(ips), asn(asn), validate(ip).

JavaScript / TypeScript

Descargar: openipapi.js

Instalar / usar

Coloque el archivo en su proyecto (o impórtelo directamente desde /sdk/javascript/openipapi.js en el navegador). Funciona en navegadores modernos y Node.js 18+. Sin paso de build, sin dependencias de terceros.

Compatibilidad de endpoints

Los cinco endpoints REST: lookup, me, batch, asn, validate. Los endpoints restringidos por plan siguen requiriendo el plan correspondiente en su clave de API.

Ejemplo

import { OpenIPApi } from '/sdk/javascript/openipapi.js';

const client = new OpenIPApi('YOUR_KEY');
const data = await client.lookup('8.8.8.8');
console.log(data.threat?.is_vpn);

// Batch lookup
const batch = await client.batch(['8.8.8.8', '1.1.1.1']);

Instalar / usar

Coloque el archivo en su proyecto e impórtelo. Python 3.8+. Usa únicamente la biblioteca estándar (urllib).

Compatibilidad de endpoints

Los cinco endpoints REST: lookup, me, batch, asn, validate. Los endpoints restringidos por plan siguen requiriendo el plan correspondiente en su clave de API.

Ejemplo

from openipapi import OpenIPApi

client = OpenIPApi("YOUR_KEY")
data = client.lookup("8.8.8.8")
print(data.get("threat", {}).get("is_vpn"))

# Batch lookup
batch = client.batch(["8.8.8.8", "1.1.1.1"])

Instalar / usar

Coloque el archivo en su proyecto y hágale require. PHP 8.0+. Usa curl cuando está disponible, con un fallback de stream context. No se requiere Composer.

Compatibilidad de endpoints

Los cinco endpoints REST: lookup, me, batch, asn, validate. Los endpoints restringidos por plan siguen requiriendo el plan correspondiente en su clave de API.

Ejemplo

require __DIR__ . '/OpenIPApiClient.php';

$client = new OpenIPApiClient('YOUR_KEY');
$data = $client->lookup('8.8.8.8');
echo !empty($data['threat']['is_vpn']) ? 'yes' : 'no';

// Batch lookup
$batch = $client->batch(['8.8.8.8', '1.1.1.1']);

Alternativa HTTP directa

No se requiere ningún SDK para usar OpenIPApi. La API es una capa REST + JSON ligera — cualquier cliente HTTP funciona:

$ curl https://api.openipapi.com/v1/lookup/8.8.8.8 \
     -H "X-API-Key: YOUR_KEY"

Las versiones en los registros de paquetes npm, PyPI y Packagist podrían añadirse más adelante.