Oficjalne SDK OpenIPApi
Pobierz lekkie oficjalne klienty dla JavaScript, Python i PHP.
Wszystkie SDK korzystają z tego samego REST API pod adresem https://api.openipapi.com, uwierzytelniają się nagłówkiem X-API-Key i udostępniają te same metody: lookup(ip), me(), batch(ips), asn(asn), validate(ip).
JavaScript / TypeScript
Pobierz: openipapi.jsInstalacja / użycie
Skopiuj plik do swojego projektu (lub zaimportuj bezpośrednio z /sdk/javascript/openipapi.js w przeglądarce). Działa we współczesnych przeglądarkach oraz w Node.js 18+. Bez kroku budowania, bez zewnętrznych zależności.
Kompatybilność endpointów
Wszystkie pięć endpointów REST: lookup, me, batch, asn, validate. Endpointy zależne od planu nadal wymagają odpowiedniego planu na kluczu API.
Przykład
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
Pobierz: openipapi.pyInstalacja / użycie
Skopiuj plik do swojego projektu i zaimportuj go. Python 3.8+. Wykorzystuje wyłącznie bibliotekę standardową (urllib).
Kompatybilność endpointów
Wszystkie pięć endpointów REST: lookup, me, batch, asn, validate. Endpointy zależne od planu nadal wymagają odpowiedniego planu na kluczu API.
Przykład
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"])
Instalacja / użycie
Skopiuj plik do swojego projektu i dołącz go przez require. PHP 8.0+. Korzysta z cURL, jeśli jest dostępny, z fallbackiem na stream context. Composer nie jest wymagany.
Kompatybilność endpointów
Wszystkie pięć endpointów REST: lookup, me, batch, asn, validate. Endpointy zależne od planu nadal wymagają odpowiedniego planu na kluczu API.
Przykład
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']);
Bezpośrednie wywołanie HTTP
Do korzystania z OpenIPApi nie jest wymagany żaden SDK. API to cienka warstwa REST + JSON — działa z dowolnym klientem HTTP:
$ curl https://api.openipapi.com/v1/lookup/8.8.8.8 \
-H "X-API-Key: YOUR_KEY"
Wersje w rejestrach pakietów npm, PyPI i Packagist mogą zostać dodane później.