SDK ufficiali OpenIPApi
Scarica i client ufficiali leggeri per JavaScript, Python e PHP.
Tutti gli SDK puntano alla stessa REST API su https://api.openipapi.com, si autenticano con l'header X-API-Key ed espongono gli stessi metodi: lookup(ip), me(), batch(ips), asn(asn), validate(ip).
JavaScript / TypeScript
Scarica: openipapi.jsInstalla / usa
Trascina il file nel tuo progetto (o importalo direttamente da /sdk/javascript/openipapi.js in un browser). Funziona nei browser moderni e in Node.js 18+. Nessuno step di build, nessuna dipendenza di terze parti.
Compatibilità degli endpoint
Tutti e cinque gli endpoint REST: lookup, me, batch, asn, validate. Gli endpoint riservati ai piani richiedono comunque il piano pertinente sulla tua chiave API.
Esempio
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']);
Python
Scarica: openipapi.pyInstalla / usa
Trascina il file nel tuo progetto e importalo. Python 3.8+. Usa solo la libreria standard (urllib).
Compatibilità degli endpoint
Tutti e cinque gli endpoint REST: lookup, me, batch, asn, validate. Gli endpoint riservati ai piani richiedono comunque il piano pertinente sulla tua chiave API.
Esempio
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"])
Installa / usa
Trascina il file nel tuo progetto e includilo con require. PHP 8.0+. Usa curl quando disponibile, con un fallback stream-context. Composer non richiesto.
Compatibilità degli endpoint
Tutti e cinque gli endpoint REST: lookup, me, batch, asn, validate. Gli endpoint riservati ai piani richiedono comunque il piano pertinente sulla tua chiave API.
Esempio
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']);
Fallback HTTP diretto
Non è richiesto alcun SDK per usare OpenIPApi. L'API è un sottile strato REST + JSON: qualsiasi client HTTP funziona:
$ curl https://api.openipapi.com/v1/lookup/8.8.8.8 \
-H "X-API-Key: YOUR_KEY"
Le versioni sui registri di pacchetti per npm, PyPI e Packagist potrebbero essere aggiunte in seguito.