Repository untuk generate （REST） API statis berisi data wilayah Indonesia — provinsi， kabupaten/kota， kecamatan， desa/kelurahan， kode pos， dan boundary polygon — serta cara mendeploynya ke static hosting （GitHub Pages / Cloudflare Pages / Vercel / Nginx）.

API statis = endpoint-nya cuma file JSON statis.Tanpa server， tanpa API key， tanpa rate limit dari kami.Tinggal fetch.

Demo / Playground： https://www.emsifa.com/api-wilayah-indonesia — coba pilih provinsi → kab/kota → kecamatan → desa， peta auto-zoom + lihat request URL real-time.

基础网址： https://www.emsifa.com/api-wilayah-indonesia/v2

Stats terbaru（GET /stats.json）：

---

Apa yang dimaksud API statis？

API statis adalah API yang endpoint-nya terdiri dari file statis （JSON）.Tidak ada server-side scripting saat request — file sudah di-generate sebelumnya.

Keuntungan API statis？

• Dapat dihosting di static file hosting seperti GitHub Pages， Netlify， Cloudflare Pages， Vercel， bahkan Nginx.
• Proses lebih cepat karena tidak butuh server — langsung di-cache CDN.
• Gratis and simpel.Cocok untuk MVP，仅前端，atau edge functions。

你是谁？

API Data Wilayah Indonesia

Repository untuk generate (REST) API statis berisi data wilayah Indonesia — provinsi, kabupaten/kota, kecamatan, desa/kelurahan, kode pos, dan boundary polygon — serta cara mendeploynya ke static hosting (GitHub Pages / Cloudflare Pages / Vercel / Nginx).

API statis = endpoint-nya cuma file JSON statis. Tanpa server, tanpa API key, tanpa rate limit dari kami. Tinggal fetch.

Demo / Playground: https://www.emsifa.com/api-wilayah-indonesia — coba pilih provinsi → kab/kota → kecamatan → desa, peta auto-zoom + lihat request URL real-time.

Base URL: https://www.emsifa.com/api-wilayah-indonesia/v2

Stats terbaru (GET /stats.json):

{
  "total_provinces": 38,
  "total_regencies": 514,
  "total_districts": 7285,
  "total_villages": 83762,
  "total_postal_codes": 10632,
  "total_paths": 91238,
  "total_endpoints": 201309
}

---

Apa yang dimaksud API statis?

API statis adalah API yang endpoint-nya terdiri dari file statis (JSON). Tidak ada server-side scripting saat request — file sudah di-generate sebelumnya.

Keuntungan API statis?

• Dapat dihosting di static file hosting seperti GitHub Pages, Netlify, Cloudflare Pages, Vercel, bahkan Nginx.
• Proses lebih cepat karena tidak butuh server — langsung di-cache CDN.
• Gratis & simpel. Cocok untuk MVP, frontend-only, atau edge functions.

Bagaimana cara kerjanya?

• Daftar wilayah disimpan di data/ berupa csv (agar mudah diedit): wilayah.csv (hirarki), wilayah_level_1_2.csv (data rich provinsi/kab-kota), wilayah_kodepos.csv (mapping kode pos).
• Script Go di tools/ dijalankan — membaca csv di data/ lalu men-generate ribuan file JSON ke api/ (api/provinces.json, api/regencies/*.json, api/districts/*.json, api/villages/*.json, api/postal-codes/*.json, api/paths/*.json, api/missings.json, api/stats.json).
• Hasil api/ tinggal di-copy ke deploy/v2/ bareng hasil build web/dist lalu di-push ke branch gh-pages (lihat .github/workflows/deploy.yml:92-115).
• API siap dihidangkan. Update otomatis tiap Minggu via cron 0 0 * * 0 (lihat deploy.yml:3).

Dua cara pakai — mau yang mana?

• Static API (fetch): Paling cepat untuk MVP / frontend. Tinggal fetch("https://www.emsifa.com/api-wilayah-indonesia/v2/provinces.json"). Tanpa DB, include polygon kalau has_path=true. Data di-cache CDN.
• Download & Self-host (soon): Butuh validasi offline, FK, atau query kompleks (WHERE postal_code = ?). Download full dataset — npx @emsifa/wilayah download --format csv|sql|json --output ./wilayah. (soon, lihat web/src/components/sections/CliSection.tsx:12-19) atau clone repo ini dan serve folder api/ di hosting kamu sendiri.

Tanya AI kamu juga bisa — install SKILL.md biar nggak ngarang kode wilayah (lihat seksi Skill untuk AI).

---

Format Response

Semua endpoint mengembalikan wrapper yang sama: