API Documentation

Gunakan API token untuk mengintegrasikan pengecekan domain Nawala ke aplikasi Anda. Dapatkan token →

Autentikasi

Sertakan API token Anda melalui query parameter token atau header x-api-token.

GET /api/v1/check?domain=reddit.com&token=nwl_xxxx...

Cek Domain

GET/api/v1/check?domain={domain}&token={token}

Periksa apakah domain diblokir oleh TrustPositif Kominfo.

Response

{
  "domain": "reddit.com",
  "status": "blocked",
  "status_kominfo": "Ada",
  "cached": true,
  "checked_at": "2026-02-12T05:00:00Z"
}

Contoh (cURL)

curl "https://yourdomain.com/api/v1/check?domain=reddit.com&token=nwl_xxxx"

Contoh (JavaScript)

const res = await fetch(
  'https://yourdomain.com/api/v1/check?domain=reddit.com&token=nwl_xxxx'
);
const data = await res.json();
console.log(data.status); // "blocked" or "not_blocked"

Contoh (Python)

import requests

res = requests.get(
    'https://yourdomain.com/api/v1/check',
    params={'domain': 'reddit.com', 'token': 'nwl_xxxx'}
)
print(res.json()['status'])  # "blocked" or "not_blocked"

Bulk Check

POST/api/v1/bulk-check

Periksa banyak domain sekaligus. Limit tergantung paket.

Request Body

{
  "domains": ["reddit.com", "google.com", "vimeo.com"],
  "token": "nwl_xxxx..."
}

Response

{
  "results": [
    { "domain": "reddit.com", "status": "blocked", "status_kominfo": "Ada" },
    { "domain": "google.com", "status": "not_blocked", "status_kominfo": "Tidak Ada" },
    { "domain": "vimeo.com", "status": "blocked", "status_kominfo": "Ada" }
  ],
  "total": 3,
  "blocked": 2,
  "not_blocked": 1,
  "checked_at": "2026-02-12T05:00:00Z"
}

Cek Penggunaan

GET/api/v1/usage?token={token}
{
  "plan": "Pro",
  "daily_limit": 500,
  "bulk_limit": 30,
  "requests_today": 42,
  "total_requests": 1205,
  "expires_at": "2026-03-12T00:00:00Z",
  "is_active": true
}

Rate Limits

PaketRequest/HariBulk LimitDurasi
Starter10010 domain30 hari
Pro50030 domain30 hari
Enterprise2.000100 domain30 hari

Status Codes

200Berhasil
400Input tidak valid (domain format salah)
401Token tidak disertakan
403Token expired / quota habis
429Rate limit exceeded
500Server error