Wilayah Indonesia – CDN & API

Dataset Wilayah Indonesia via CDN & API

Provinsi → Kab/Kota → Kecamatan → Kelurahan + Kode Pos. Disajikan langsung dari repo GitHub kamu melalui jsDelivr atau API Endpoint. Tidak perlu server/backend.

  • ⚡ Cepat & tahan spike
  • 🧩 File kecil per wilayah
  • 🔒 CORS-ready untuk browser
Coba Demo Baca Docs
Mode
CDN API
Base Data (read-only)
CDN

CDN: pin versi dengan tag, mis: https://cdn.jsdelivr.net/gh/fransiskusch/wilayah-indo@v1.0.0/data
API: gunakan endpoint yang tersedia di Cloudflare Workers

Demo Dropdown Berantai

Halaman ini bisa fetch dari CDN jsDelivr atau API endpoint. Pilih mode di atas untuk mengganti sumber data.

Respon JSON terakhir
Cara pakai (dua mode)
Mode CDN:
  1. Langsung dari jsDelivr CDN
  2. Pin versi dengan Git tag untuk produksi
Mode API:
  1. Melalui Cloudflare Workers API
  2. Caching otomatis dan optimized response
Contoh cURL
# CDN Mode
    curl "https://cdn.jsdelivr.net/gh/fransiskusch/wilayah-indo/data/provinces.json"
    
    # API Mode
    curl "https://wilayah-api.franskristiono.workers.dev/api/provinces"

Dokumentasi Endpoint

Tersedia dalam dua mode: CDN statis dan API endpoint dengan caching.

🚀 Quick Start

1. Langsung pakai dari jsDelivr CDN

// Fetch semua provinsi
const provinces = await fetch('https://cdn.jsdelivr.net/gh/fransiskusch/wilayah-indo/data/provinces.json')
  .then(response => response.json());

// Fetch kabupaten/kota berdasarkan kode provinsi (contoh: DKI Jakarta = 31)
const regencies = await fetch('https://cdn.jsdelivr.net/gh/fransiskusch/wilayah-indo/data/regencies/31.json')
  .then(response => response.json());

2. Pin versi untuk produksi (recommended)

// Gunakan tag versi untuk cache yang stabil
const BASE_URL = 'https://cdn.jsdelivr.net/gh/fransiskusch/wilayah-indo@v1.0.0/data';
const provinces = await fetch(`${BASE_URL}/provinces.json`).then(r => r.json());

CDN Endpoints

Provinsi
GET /data/provinces.json
Kabupaten/Kota
GET /data/regencies/:prov.json contoh: 31.json
Kecamatan
GET /data/districts/:prov.:reg.json contoh: 31.74.json
Kelurahan + Kode Pos
GET /data/postal/:prov/:reg/:dist.json contoh: 31/74/06.json
Base URL:
https://cdn.jsdelivr.net/gh/fransiskusch/wilayah-indo

API Endpoints

Provinsi
GET /api/provinces
Kabupaten/Kota
GET /api/regencies/:prov contoh: /api/regencies/31
Kecamatan
GET /api/districts/:reg contoh: /api/districts/31.74
Kelurahan + Kode Pos
GET /api/postal/:p/:r/:d contoh: /api/postal/31/74/06
Base URL:
https://wilayah-api.franskristiono.workers.dev

Struktur Response

Provinsi/Kabupaten/Kecamatan:
[
  {
    "code": "31",
    "name": "DKI Jakarta"
  },
  {
    "code": "32", 
    "name": "Jawa Barat"
  }
]
Kelurahan + Kode Pos:
[
  {
    "code": "31.74.06.1001",
    "village": "Menteng",
    "postal_code": "10310"
  }
]

💡 Contoh Penggunaan

JavaScript/TypeScript

// Fungsi helper untuk fetch data
class WilayahIndonesia {
  constructor(mode = 'cdn', version = 'latest') {
    this.baseUrl = mode === 'api' 
      ? 'https://wilayah-api.franskristiono.workers.dev'
      : `https://cdn.jsdelivr.net/gh/fransiskusch/wilayah-indo${version !== 'latest' ? '@' + version : ''}/data`;
    this.isApiMode = mode === 'api';
  }

  async getProvinces() {
    const endpoint = this.isApiMode ? '/api/provinces' : '/provinces.json';
    return this.fetch(endpoint);
  }

  async getRegencies(provinceCode) {
    const endpoint = this.isApiMode 
      ? `/api/regencies/${provinceCode}`
      : `/regencies/${provinceCode}.json`;
    return this.fetch(endpoint);
  }

  async fetch(endpoint) {
    const response = await fetch(this.baseUrl + endpoint);
    return response.json();
  }
}

// Penggunaan
const wilayah = new WilayahIndonesia('api'); // atau 'cdn'
const provinces = await wilayah.getProvinces();

cURL Commands

# CDN Mode - Semua provinsi
curl "https://cdn.jsdelivr.net/gh/fransiskusch/wilayah-indo/data/provinces.json"

# CDN Mode - Pin versi
curl "https://cdn.jsdelivr.net/gh/fransiskusch/wilayah-indo@v1.0.0/data/provinces.json"

# API Mode - Semua provinsi  
curl "https://wilayah-api.franskristiono.workers.dev/api/provinces"

# API Mode - Kabupaten di DKI Jakarta
curl "https://wilayah-api.franskristiono.workers.dev/api/regencies/31"

# API Mode - Kecamatan di Jakarta Pusat
curl "https://wilayah-api.franskristiono.workers.dev/api/districts/31.74"

💡 Tips Produksi

  • ✓
    CDN: Pin versi dengan tag @v1.0.0 untuk cache stabil
  • ✓
    API: Caching otomatis 24 jam, lebih konsisten untuk produksi
  • ✓
    Kedua mode mendukung CORS, aman dipanggil dari browser
  • ✓
    Implementasikan error handling untuk network failures

❓ FAQ

Perbedaan CDN dan API?

CDN langsung dari GitHub repo via jsDelivr, sedangkan API melalui Cloudflare Workers dengan caching otomatis.

Mana yang lebih baik untuk produksi?

API lebih stabil dengan caching konsisten. CDN lebih ringan tapi bergantung pada GitHub repo.

Bagaimana versi data?

CDN: gunakan tag repo @v1.0.0. API: selalu menggunakan data terbaru dari repo.