IP Checker Logo

Dokumentasi API & Pengembang

API JSON yang kecil dan mudah diprediksi. Seluruh endpoint dijembatani di sisi server melalui lapisan abstraksi penyedia kami, dilengkapi normalisasi respons, cache ringan, dan penanganan kesalahan yang anggun.

Endpoint

GET /api/my-ip

Mengembalikan geolokasi dan data jaringan untuk IP publik pemanggil, seperti yang terlihat oleh server.

curl https://ipcheck.mubarokah.com/api/my-ip

GET /api/lookup?q=<ip|domain>

Cari IPv4, IPv6, atau domain telanjang apa pun. Skema protokol (http/https) dan path akan ditolak.

curl "https://ipcheck.mubarokah.com/api/lookup?q=8.8.8.8"

POST /api/bulk

Pencarian massal (hingga 50 per permintaan). Konkurensi dibatasi di sisi server.

curl -X POST -H 'content-type: application/json' \
  -d '{"queries":["8.8.8.8","1.1.1.1","example.com"]}' \
  https://ipcheck.mubarokah.com/api/bulk

Bentuk Respons

{
  "ok": true,
  "query": "8.8.8.8",
  "ip": "8.8.8.8",
  "ipVersion": "IPv4",
  "location": {
    "continent": "North America",
    "country": "United States",
    "countryCode": "US",
    "regionName": "Virginia",
    "city": "Ashburn",
    "zip": "20149",
    "lat": 39.0438,
    "lon": -77.4874,
    "timezone": "America/New_York",
    "utcOffsetSeconds": -14400,
    "currency": "USD"
  },
  "network": {
    "isp": "Google LLC",
    "org": "Google Public DNS",
    "as": "AS15169 Google LLC",
    "asname": "GOOGLE",
    "reverse": "dns.google"
  },
  "flags": { "mobile": false, "proxy": false, "hosting": true }
}

Kesalahan (Errors)

Batas Panggilan & Cache

Respons disimpan di cache sisi server selama 10 menit per kueri. Tingkat publik gratis dari penyedia hulu dibatasi secara ketat dan ditujukan untuk penggunaan non-komersial. Untuk lalu lintas produksi, kami menyarankan untuk mengonfigurasi penyedia komersial melalui variabel lingkungan yang didokumentasikan di bawah ini.

Abstraksi Penyedia

Atur variabel lingkungan berikut di server Anda. Kunci rahasia tidak akan pernah diekspos ke peramban pengguna.

IP_PROVIDER=ip-api            # or ip-api-pro
IP_API_KEY=...                # required for pro
IP_API_BASE=http://ip-api.com

Catatan Penting