OpenIPApi

Oficiální OpenIPApi SDK

Stáhněte si lehké oficiální klienty pro JavaScript, Python a PHP.

Všechna SDK cílí stejné REST API na https://api.openipapi.com, autentizují se hlavičkou X-API-Key a poskytují stejné metody: lookup(ip), me(), batch(ips), asn(asn), validate(ip).

JavaScript / TypeScript

Stáhnout: openipapi.js

Instalace / použití

Vložte soubor do svého projektu (nebo importujte přímo z /sdk/javascript/openipapi.js v prohlížeči). Funguje v moderních prohlížečích a Node.js 18+. Bez build kroku a bez závislostí třetích stran.

Kompatibilita endpointů

Všech pět REST endpointů: lookup, me, batch, asn, validate. Endpointy vázané na plán stále vyžadují odpovídající plán u vašeho API klíče.

Příklad

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']);

Instalace / použití

Vložte soubor do projektu a importujte ho. Python 3.8+. Používá pouze standardní knihovnu (urllib).

Kompatibilita endpointů

Všech pět REST endpointů: lookup, me, batch, asn, validate. Endpointy vázané na plán stále vyžadují odpovídající plán u vašeho API klíče.

Příklad

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"])

Instalace / použití

Vložte soubor do projektu a načtěte ho přes require. PHP 8.0+. Používá curl, pokud je dostupné, jinak fallback přes stream context. Composer není potřeba.

Kompatibilita endpointů

Všech pět REST endpointů: lookup, me, batch, asn, validate. Endpointy vázané na plán stále vyžadují odpovídající plán u vašeho API klíče.

Příklad

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']);

Přímý HTTP fallback

K používání OpenIPApi není SDK nutné. API je tenká REST + JSON vrstva — funguje s jakýmkoli HTTP klientem:

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

Verze v balíčkových registrech npm, PyPI a Packagist mohou být přidány později.