IP Checker Logo

Dokumentasi API & Pembangun

API JSON yang kecil dan mudah diramal. Endpoint diproksi melalui lapisan abstraksi penyedia pelayan kami, dengan normalisasi respons, cache ringan, dan pengendalian ralat yang lancar.

Endpoint

GET /api/my-ip

Mengembalikan geolokasi dan data rangkaian untuk IP awam pemanggil, seperti yang dilihat oleh pelayan.

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

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

Cari sebarang IPv4, IPv6 atau domain kosong. Protokol (http/https) dan laluan (path) ditolak.

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

POST /api/bulk

Pencarian pukal (sehingga 50 setiap permintaan). Had konkurensi dihadkan di sisi pelayan.

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

Format 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 }
}

Ralat

Had Kadar & Caching

Respons disimpan dalam cache sisi pelayan selama 10 minit bagi setiap kueri. Pelan awam percuma penyedia hulu adalah terhad dan bertujuan untuk kegunaan bukan komersial sahaja. Untuk trafik pengeluaran kami mengesyorkan anda mengkonfigurasi penyedia komersial melalui pembolehubah persekitaran yang didokumenkan di bawah.

Abstraksi Penyedia

Tetapkan pembolehubah persekitaran berikut pada pelayan. Kunci rahsia tidak akan didedahkan kepada pelayar web.

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

Nota