Siapa pun yang mengelola lebih dari segelintir domain di Indonesia pernah mengalami ini: situs normal di jaringan kantor, tapi pengunjung dari operator seluler tertentu melihat halaman blokir. Penyebabnya bisa daftar TrustPositif Komdigi (dulu dikenal sebagai Internet Positif, sering disebut “kena Nawala”), bisa juga filter DNS milik operator itu sendiri. Mengecek satu per satu lewat situs web cepat melelahkan. Tulisan ini membahas cara mengeceknya lewat API, sehingga bisa dijalankan dari terminal atau dimasukkan ke skrip pemantauan.

Alat yang dipakai

Yang dicoba adalah API Nawala Checker gratis yang dibagikan pengelola forum N3 (Nyit-Nyit.Net) di thread API Nawala Checker Gratis. Menurut thread tersebut, API ini:

  • gratis, dengan kuota 100 request per hari per API key;
  • bisa mengecek satu domain atau banyak domain sekaligus (dipisah koma);
  • mengembalikan status per penyedia, bukan hanya satu kesimpulan.

API key didapat dari thread itu. Di contoh berikut, ganti API_KEY_ANDA dengan key milikmu sendiri.

Tiga endpoint yang perlu diketahui

Cek satu domain:

curl -s "https://epiai.h80.org/check-domain?api_key=API_KEY_ANDA&domain=contoh.com"

Cek beberapa domain dalam satu request:

curl -s "https://epiai.h80.org/check-domain?api_key=API_KEY_ANDA&domain=contoh.com,contoh.net,contoh.org"

Cek sisa kuota:

curl -s "https://epiai.h80.org/my-usage?api_key=API_KEY_ANDA"

Membaca hasilnya

Hasilnya JSON. Setiap domain punya status ringkas (blocked atau tidak) dan daftar provider_info. Bagian kedua ini yang paling berguna, karena blokir di Indonesia tidak seragam. Contoh pola yang mungkin muncul:

SumberHasilArtinya
Kominfo / TrustPositifALLOWEDDomain tidak ada di daftar pemerintah
Satu operator selulerBLOCKEDOperator itu memblokir lewat filternya sendiri
Operator lainALLOWEDPengunjung di jaringan ini tidak terdampak

Jadi kalau hanya satu operator yang memblokir, langkah penanganannya berbeda dengan blokir dari daftar pemerintah. Status per penyedia membantu memutuskan harus melapor ke mana.

Contoh skrip harian

Skrip kecil berikut membaca daftar domain dari berkas, mengirimkannya dalam satu request, lalu mencetak domain yang terblokir di penyedia mana pun. Butuh curl dan jq.

#!/usr/bin/env bash
# cek-nawala.sh — daftar domain di domains.txt, satu per baris
KEY="API_KEY_ANDA"
LIST=$(grep -v '^#' domains.txt | paste -sd, -)
curl -s "https://epiai.h80.org/check-domain?api_key=${KEY}&domain=${LIST}" \
  | jq -r '.results[]
      | select(.status == "blocked")
      | "\(.domain): " + ([.provider_info[]
          | select(.readable_result == "BLOCKED") | .provider_name] | join(", "))'

Jadwalkan sekali sehari dengan cron (lihat Menjadwalkan Tugas Otomatis dengan cron). Dengan kuota 100 request per hari dan banyak domain per request, satu kali jalan per hari masih sangat longgar, bahkan untuk portofolio domain yang cukup besar.

Kapan alat ini berguna

  • Sebelum membeli domain bekas. Domain lama bisa saja sudah masuk daftar blokir karena pemilik sebelumnya. Cek dulu sebelum membayar.
  • Setelah situs pindah server atau IP. Memastikan tidak ada operator yang tiba-tiba memblokir.
  • Untuk agensi dan pengelola banyak situs klien. Laporan harian lebih cepat daripada menunggu keluhan pengunjung.

Batasannya

  • Hasil adalah pengecekan pada satu waktu dari titik pengecekan penyedia API, bukan jaminan kondisi di setiap jaringan rumah atau kantor.
  • Kuota gratis 100 request per hari. Jangan mengulang pengecekan dalam loop rapat; selain boros kuota, itu juga membebani layanan gratis yang dipakai banyak orang.
  • API key bersifat pribadi. Jangan menaruhnya di repositori publik (tips menjaganya ada di Mencegah Kebocoran Rahasia di Repositori Git).
  • Alat ini hanya memberi tahu status. Kalau domain terblokir dan kamu yakin kontennya sah, proses keberatan tetap harus dilakukan lewat kanal resmi.

Kesimpulan

Untuk pemilik satu situs, cek manual sesekali sudah cukup. Untuk yang mengelola puluhan domain, API dengan status per penyedia jauh lebih praktis, apalagi kalau dijalankan otomatis tiap hari. Pertanyaan atau laporan hasil yang janggal bisa langsung disampaikan di thread N3 tempat API ini dibagikan.