Rannz Network Utility API | Rannz API Factory

Siap, belum diperiksaFree + PremiumDibuat Rannz

Rannz Network Utility API

Klasifikasi IP, kalkulator CIDR, DNS lookup, dan reverse DNS.

Tentang API ini

Klasifikasi IP dan kalkulator CIDR dihitung lokal. DNS lookup memakai resolver server Rannz; hostname internal ditolak dan alamat privat disembunyikan agar fitur ini tidak bisa dipakai memindai jaringan internal. DNS semua record dan reverse DNS adalah Premium.

Informasi

Status: Siap, belum diperiksaImplementasi tersedia tetapi belum lulus pemeriksaan operasional.
Pemeriksaan terakhir: Belum pernah diperiksa
Autentikasi sumber: Authorization: Bearer <API key Rannz>. Buat key di dashboard setelah login.
Batas pemakaian: Mengikuti paket Anda: Free atau Premium. Lihat header X-RateLimit-* dan X-Quota-* pada setiap respons.
Sumber data: Perhitungan lokal & DNS resolver sistem
Dokumentasi resmi: Buka dokumentasi
Lisensi: Tanpa sumber data pihak ketiga. Jawaban DNS bergantung pada resolver server dan bisa berbeda dari resolver lain.
Kategori: Networking

Endpoint (5)

Coba di API Explorer

GET/api/v1/network/ipFree

Klasifikasi alamat IP

Menentukan versi (IPv4/IPv6) dan kategori alamat (publik, privat, loopback, link-local, dll). Tanpa parameter ip, yang diperiksa adalah alamat IP pemanggil. Dihitung lokal.

Parameter	Lokasi	Tipe	Wajib	Keterangan
ip	query	string	Tidak	Alamat IPv4/IPv6. Kosong = IP pemanggil.

Contoh request

curl "https://layananapirannz.web.id/api/v1/network/ip?ip=8.8.8.8" \
  -H "Authorization: Bearer YOUR_API_KEY"

Contoh respons sukses (200)

{
  "data": {
    "ip": "8.8.8.8",
    "version": 4,
    "category": "public",
    "isPublic": true
  },
  "meta": {
    "requestId": "…",
    "endpoint": "network.ip",
    "cached": false
  }
}

Contoh respons error

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "Input tidak valid.",
    "requestId": "…",
    "details": [
      {
        "field": "ip",
        "message": "Parameter wajib diisi"
      }
    ]
  }
}

400 INVALID_INPUT Input tidak valid (parameter hilang, tipe salah, atau di luar batas).
401 INVALID_API_KEY API key tidak ada, salah format, dicabut, atau kedaluwarsa.
403 PREMIUM_REQUIRED Endpoint membutuhkan paket Premium aktif untuk layanan tersebut.
403 KEY_RESTRICTED API key dibatasi dan tidak boleh mengakses layanan ini.
404 NOT_FOUND Endpoint atau data yang diminta tidak ditemukan.
429 RATE_LIMITED Rate limit per menit terlampaui. Lihat header Retry-After.
429 QUOTA_EXCEEDED Kuota harian terlampaui. Kuota direset 00:00 UTC.
502 UPSTREAM_ERROR Sumber data (provider upstream) gagal atau mengembalikan respons tidak valid.
502 UPSTREAM_TIMEOUT Sumber data tidak merespons dalam batas waktu.

GET/api/v1/network/cidrFree

Kalkulator subnet CIDR IPv4

Alamat jaringan, broadcast, netmask, rentang host, dan jumlah host. Dihitung lokal.

Parameter	Lokasi	Tipe	Wajib	Keterangan
cidr	query	string	Ya	Notasi CIDR IPv4.

Contoh request

curl "https://layananapirannz.web.id/api/v1/network/cidr?cidr=192.168.10.0%2F24" \
  -H "Authorization: Bearer YOUR_API_KEY"

Contoh respons sukses (200)

{
  "data": {
    "cidr": "192.168.10.0/24",
    "prefix": 24,
    "network": "192.168.10.0",
    "broadcast": "192.168.10.255",
    "netmask": "255.255.255.0",
    "wildcard": "0.0.0.255",
    "firstHost": "192.168.10.1",
    "lastHost": "192.168.10.254",
    "totalAddresses": 256,
    "usableHosts": 254
  },
  "meta": {
    "requestId": "…",
    "endpoint": "network.cidr",
    "cached": false
  }
}

Nilai pada contoh bersifat ilustrasi; bentuk (skema) respons sama dengan yang sebenarnya.

Contoh respons error

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "Input tidak valid.",
    "requestId": "…",
    "details": [
      {
        "field": "cidr",
        "message": "Parameter wajib diisi"
      }
    ]
  }
}

400 INVALID_INPUT Input tidak valid (parameter hilang, tipe salah, atau di luar batas).
401 INVALID_API_KEY API key tidak ada, salah format, dicabut, atau kedaluwarsa.
403 PREMIUM_REQUIRED Endpoint membutuhkan paket Premium aktif untuk layanan tersebut.
403 KEY_RESTRICTED API key dibatasi dan tidak boleh mengakses layanan ini.
404 NOT_FOUND Endpoint atau data yang diminta tidak ditemukan.
429 RATE_LIMITED Rate limit per menit terlampaui. Lihat header Retry-After.
429 QUOTA_EXCEEDED Kuota harian terlampaui. Kuota direset 00:00 UTC.
502 UPSTREAM_ERROR Sumber data (provider upstream) gagal atau mengembalikan respons tidak valid.
502 UPSTREAM_TIMEOUT Sumber data tidak merespons dalam batas waktu.

GET/api/v1/network/dnsFreecache 1 menit

DNS lookup satu jenis record

Mengambil record DNS publik dari resolver server Rannz. Alamat A/AAAA yang menunjuk ke jaringan privat disembunyikan dan dihitung di filteredPrivateAddresses.

Parameter	Lokasi	Tipe	Wajib	Keterangan
host	query	string	Ya	Nama domain publik (bukan IP, bukan hostname internal).
type	query	A \| AAAA \| CNAME \| MX \| NS \| TXT \| SOA	Tidak	Jenis record. Default: A.

Contoh request

curl "https://layananapirannz.web.id/api/v1/network/dns?host=example.com" \
  -H "Authorization: Bearer YOUR_API_KEY"

Contoh respons sukses (200)

{
  "data": {
    "host": "example.com",
    "type": "A",
    "status": "OK",
    "records": [
      "93.184.216.34"
    ],
    "filteredPrivateAddresses": 0
  },
  "meta": {
    "requestId": "…",
    "endpoint": "network.dns",
    "cached": false
  }
}

Nilai pada contoh bersifat ilustrasi; bentuk (skema) respons sama dengan yang sebenarnya.

Contoh respons error

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "Input tidak valid.",
    "requestId": "…",
    "details": [
      {
        "field": "host",
        "message": "Parameter wajib diisi"
      }
    ]
  }
}

400 INVALID_INPUT Input tidak valid (parameter hilang, tipe salah, atau di luar batas).
401 INVALID_API_KEY API key tidak ada, salah format, dicabut, atau kedaluwarsa.
403 PREMIUM_REQUIRED Endpoint membutuhkan paket Premium aktif untuk layanan tersebut.
403 KEY_RESTRICTED API key dibatasi dan tidak boleh mengakses layanan ini.
404 NOT_FOUND Endpoint atau data yang diminta tidak ditemukan.
429 RATE_LIMITED Rate limit per menit terlampaui. Lihat header Retry-After.
429 QUOTA_EXCEEDED Kuota harian terlampaui. Kuota direset 00:00 UTC.
502 UPSTREAM_ERROR Sumber data (provider upstream) gagal atau mengembalikan respons tidak valid.
502 UPSTREAM_TIMEOUT Sumber data tidak merespons dalam batas waktu.

GET/api/v1/network/dns/allPremiumcache 1 menit

DNS lookup semua jenis record sekaligus

A, AAAA, CNAME, MX, NS, TXT, dan SOA dalam satu panggilan. Endpoint Premium.

Parameter	Lokasi	Tipe	Wajib	Keterangan
host	query	string	Ya	Nama domain publik (bukan IP, bukan hostname internal).

Contoh request

curl "https://layananapirannz.web.id/api/v1/network/dns/all?host=example.com" \
  -H "Authorization: Bearer YOUR_API_KEY"

Contoh respons sukses (200)

{
  "data": {
    "host": "example.com",
    "answers": [
      {
        "type": "A",
        "status": "OK",
        "records": [
          "93.184.216.34"
        ]
      }
    ]
  },
  "meta": {
    "requestId": "…",
    "endpoint": "network.dns.all",
    "cached": false
  }
}

Nilai pada contoh bersifat ilustrasi; bentuk (skema) respons sama dengan yang sebenarnya.

Contoh respons error

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "Input tidak valid.",
    "requestId": "…",
    "details": [
      {
        "field": "host",
        "message": "Parameter wajib diisi"
      }
    ]
  }
}

400 INVALID_INPUT Input tidak valid (parameter hilang, tipe salah, atau di luar batas).
401 INVALID_API_KEY API key tidak ada, salah format, dicabut, atau kedaluwarsa.
403 PREMIUM_REQUIRED Endpoint membutuhkan paket Premium aktif untuk layanan tersebut.
403 KEY_RESTRICTED API key dibatasi dan tidak boleh mengakses layanan ini.
404 NOT_FOUND Endpoint atau data yang diminta tidak ditemukan.
429 RATE_LIMITED Rate limit per menit terlampaui. Lihat header Retry-After.
429 QUOTA_EXCEEDED Kuota harian terlampaui. Kuota direset 00:00 UTC.
502 UPSTREAM_ERROR Sumber data (provider upstream) gagal atau mengembalikan respons tidak valid.
502 UPSTREAM_TIMEOUT Sumber data tidak merespons dalam batas waktu.

GET/api/v1/network/reversePremiumcache 5 menit

Reverse DNS (PTR) alamat IP publik

Hostname yang terkait dengan sebuah IP publik. IP privat ditolak. Endpoint Premium.

Parameter	Lokasi	Tipe	Wajib	Keterangan
ip	query	string	Ya	Alamat IP publik.

Contoh request

curl "https://layananapirannz.web.id/api/v1/network/reverse?ip=8.8.8.8" \
  -H "Authorization: Bearer YOUR_API_KEY"

Contoh respons sukses (200)

{
  "data": {
    "ip": "8.8.8.8",
    "hostnames": [
      "dns.google"
    ]
  },
  "meta": {
    "requestId": "…",
    "endpoint": "network.reverse",
    "cached": false
  }
}

Nilai pada contoh bersifat ilustrasi; bentuk (skema) respons sama dengan yang sebenarnya.

Contoh respons error

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "Input tidak valid.",
    "requestId": "…",
    "details": [
      {
        "field": "ip",
        "message": "Parameter wajib diisi"
      }
    ]
  }
}

400 INVALID_INPUT Input tidak valid (parameter hilang, tipe salah, atau di luar batas).
401 INVALID_API_KEY API key tidak ada, salah format, dicabut, atau kedaluwarsa.
403 PREMIUM_REQUIRED Endpoint membutuhkan paket Premium aktif untuk layanan tersebut.
403 KEY_RESTRICTED API key dibatasi dan tidak boleh mengakses layanan ini.
404 NOT_FOUND Endpoint atau data yang diminta tidak ditemukan.
429 RATE_LIMITED Rate limit per menit terlampaui. Lihat header Retry-After.
429 QUOTA_EXCEEDED Kuota harian terlampaui. Kuota direset 00:00 UTC.
502 UPSTREAM_ERROR Sumber data (provider upstream) gagal atau mengembalikan respons tidak valid.
502 UPSTREAM_TIMEOUT Sumber data tidak merespons dalam batas waktu.