API Cek Nawala

Dokumentasi lengkap untuk menggunakan API pengecekan status pemblokiran domain Nawala & TrustPositif

Quick Reference

Informasi penting untuk memulai menggunakan API

Base URL

https://hackbitt.com/api/

Authentication

Bearer Token

Format

JSON

Referensi

Nawala & TrustPositif

Overview

API Cek Nawala adalah layanan RESTful API untuk memeriksa status pemblokiran domain di database Nawala Project dan TrustPositif Kominfo. API ini menggunakan 2 referensi website resmi untuk memastikan akurasi data.

Referensi Website

  • Nawala DNS: Sistem DNS filtering untuk memblokir konten negatif
  • TrustPositif Kominfo: Database resmi Kominfo untuk pemblokiran domain

Authentication

API menggunakan API Key untuk autentikasi. Sertakan API Key Anda di header setiap request:

Authorization: Bearer YOUR_API_KEY

Note: Dapatkan API Key dengan mendaftar di halaman Paket.

Endpoints

GET

/check

Mengecek status pemblokiran satu domain

Parameters

Parameter Type Required Description
domain string Yes Domain yang ingin dicek (contoh: example.com)

Example Request

GET https://hackbitt.com/api/check?domain=example.com
Authorization: Bearer YOUR_API_KEY

Example Response

{
  "success": true,
  "data": {
    "domain": "example.com",
    "nawala": {
      "blocked": false,
      "status": "clean",
      "checked_at": "2025-01-15T10:30:00Z"
    },
    "trustpositif": {
      "blocked": false,
      "status": "clean",
      "checked_at": "2025-01-15T10:30:00Z"
    },
    "overall_status": "clean",
    "checked_at": "2025-01-15T10:30:00Z"
  }
}
POST

/check/bulk

Mengecek status pemblokiran multiple domain sekaligus (maksimal 100 domain)

Request Body

{
  "domains": [
    "example.com",
    "test.com",
    "domain.com"
  ]
}

Example Request

POST https://hackbitt.com/api/check/bulk
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "domains": ["example.com", "test.com"]
}

Example Response

{
  "success": true,
  "data": [
    {
      "domain": "example.com",
      "nawala": {
        "blocked": false,
        "status": "clean"
      },
      "trustpositif": {
        "blocked": false,
        "status": "clean"
      },
      "overall_status": "clean"
    },
    {
      "domain": "test.com",
      "nawala": {
        "blocked": true,
        "status": "blocked"
      },
      "trustpositif": {
        "blocked": false,
        "status": "clean"
      },
      "overall_status": "blocked"
    }
  ],
  "checked_at": "2025-01-15T10:30:00Z"
}

Response Codes

Code Description
200 Success
400 Bad Request - Parameter tidak valid
401 Unauthorized - API Key tidak valid atau tidak ada
429 Too Many Requests - Limit request terlampaui
500 Internal Server Error

Code Examples 

<?php
$domain = 'example.com';
$apiKey = 'YOUR_API_KEY';
$url = 'https://hackbitt.com/api/check?domain=' . urlencode($domain);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer ' . $apiKey
]);

$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);
?>
const domain = 'example.com';
const apiKey = 'YOUR_API_KEY';

fetch(`https://hackbitt.com/api/check?domain=${domain}`, {
    headers: {
        'Authorization': `Bearer ${apiKey}`
    }
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
import requests

domain = 'example.com'
api_key = 'YOUR_API_KEY'
url = 'https://hackbitt.com/api/check'

headers = {
    'Authorization': f'Bearer {api_key}'
}

params = {
    'domain': domain
}

response = requests.get(url, headers=headers, params=params)
data = response.json()
print(data)
curl -X GET \
  "https://hackbitt.com/api/check?domain=example.com" \
  -H "Authorization: Bearer YOUR_API_KEY"

Rate Limits

Rate limit bervariasi sesuai dengan paket yang Anda pilih:

Starter

50.000

request/bulan

Professional

300.000

request/bulan

Enterprise

Unlimited

request/bulan

Rate limit dihitung sejak tanggal pembelian paket dan akan direset setiap 30 hari sejak tanggal pembelian.

Support

Jika Anda membutuhkan bantuan atau memiliki pertanyaan tentang API, silakan hubungi: