⚡ Cloudflare Edge Network: Jakarta (CGK) PoP Aktif · OpenAPI 3.1 Spec · Zero API Key

KodeKecil Edge APIs Reference

Spesifikasi teknis Micro-APIs publik gratis untuk ekosistem developer Indonesia. Dijalankan di Cloudflare Edge runtime V8 dengan latensi sub-30ms, auto-caching, dan tanpa auth token.

Base URL: https://api.kodekecil.my.id Versi: v1.0.0 (Latest) Protokol: HTTP/2 & HTTP/3 over TLS CORS: * (Access-Control-Allow-Origin)
GET /v1/hari-libur

Hari Libur Nasional & Cuti Bersama

Mengembalikan daftar resmi tanggal merah dan cuti bersama di Indonesia berdasarkan Keputusan Bersama (SKB) 3 Menteri (Menteri Agama, Menteri Ketenagakerjaan, dan MenPAN-RB). Sangat cocok untuk validasi jadwal kerja, SLA pengiriman barang, dan kalkulasi payroll.

Query Parameters

Parameter Tipe Status Keterangan Contoh
year integer Opsional Tahun kalender (2025, 2026, 2027). Default ke tahun berjalan. 2026
type string Opsional Filter jenis: all, national, atau joint_leave. all
month integer Opsional Filter bulan kalender (1 sampai 12). 5

Contoh Respon JSON (200 OK)

{
  "status": "success",
  "data": {
    "year": 2026,
    "total_holidays": 27,
    "national_holidays_count": 17,
    "joint_leave_count": 10,
    "holidays": [
      {
        "date": "2026-01-01",
        "name": "Tahun Baru 2026 Masehi",
        "type": "national",
        "is_joint_leave": false
      }
    ]
  }
}
GET /v1/wilayah/provinsi

Master 38 Provinsi Indonesia

Data referensi resmi 38 provinsi di Republik Indonesia pasca pemekaran Papua (Papua Selatan, Papua Tengah, Papua Pegunungan, Papua Barat Daya) lengkap dengan kode standar BPS/Kemendagri, ibukota provinsi, dan zona pulau.

Query Parameters

Parameter Tipe Status Keterangan Contoh
island string Opsional Filter berdasarkan kepulauan: Jawa, Sumatera, Kalimantan, Sulawesi, Bali & Nusa Tenggara, Papua, Maluku. Jawa
GET /v1/wilayah/search

Pencarian Cepat Wilayah

Pencarian fuzzy nama provinsi, ibukota, atau kode wilayah untuk keperluan form autocomplete alamat pada e-commerce dan aplikasi logistik.

Query Parameters

Parameter Tipe Status Keterangan Contoh
q string Wajib Kata kunci pencarian (nama provinsi atau nama ibukota). Minimal 1 karakter. Bandung
GET /v1/wilayah/kodepos

Database Kode Pos Indonesia

Pencarian kode pos 5 digit berdasarkan nama kelurahan, kecamatan, kota, maupun pencarian balik nomor kode pos untuk kebutuhan form pengiriman checkout belanja online.

Query Parameters

Parameter Tipe Status Keterangan Contoh
q string Opsional Kata kunci pencarian (nomor kode pos, kelurahan, kecamatan, atau kota). 40115
city string Opsional Filter spesifik nama kota atau kabupaten. Bandung
limit integer Opsional Batas jumlah hasil pencarian (default: 25, maks: 100). 10
GET /v1/kurs

Kurs Valuta Asing Acuan IDR

Kurs referensi mata uang utama dunia terhadap Rupiah (IDR): USD, SGD, EUR, JPY, MYR, AUD, GBP, CNY, SAR. Berguna untuk kalkulasi harga multi-currency dan konversi invoice.

Query Parameters

Parameter Tipe Status Keterangan Contoh
amount number Opsional Nilai nominal valas yang hendak dikonversikan ke IDR. Default: 1. 100
symbols string Opsional Filter kode ISO valas dipisahkan tanda koma. USD,SGD,EUR
GET /v1/terbilang

Konverter Terbilang Rupiah

Mengonversi nominal angka ke dalam ejaan teks bahasa Indonesia baku untuk kwitansi, faktur pajak, invoice, slip gaji, dan laporan keuangan. Mendukung angka hingga triliunan, nilai minus/negatif, serta desimal/sen. Mendukung metode GET dan POST.

Query / Body Parameters

Parameter Tipe Status Keterangan Contoh
amount number Wajib Nominal angka yang hendak dieja dalam teks rupiah. 15250000
GET /v1/id/nik

Parser & Validator NIK KTP

Validasi dan ekstraksi otomatis data kependudukan dari 16 digit Nomor Induk Kependudukan (NIK) berbasis aturan resmi Kemendagri: mendeteksi jenis kelamin, tanggal lahir (termasuk aturan wanita +40 hari), usia, zodiak, dan nama provinsi asal. 100% aman privasi di edge tanpa menyimpan data pengguna. Mendukung metode GET dan POST.

Query / Body Parameters

Parameter Tipe Status Keterangan Contoh
nik string Wajib 16 digit angka NIK tanpa spasi atau tanda baca. 3273011505980001
POST /v1/qris/decode

QRIS EMVCo TLV Decoder & CRC-16 Validator

Parser spesifikasi standar QRIS Bank Indonesia (ASPI / EMVCo MPM). Melakukan validasi checksum polinomial CRC-16/CCITT-FALSE, mendeteksi tipe QR (Statik vs Dinamik), nama merchant, National Merchant ID (NMID), kota merchant, kode pos, dan nilai transaksi.

Request Body (application/json)

Field Tipe Status Keterangan
payload string Wajib Raw string QR code berformat EMVCo Tag-Length-Value (dimulai dari Tag 00).
GET /health

Edge Telemetry & Health Check

Pemeriksaan integritas serverless worker, deteksi colo datacenter Cloudflare terdekat pengguna, status uptime, dan versi runtime.

DOCS Standardisasi & Regulasi Resmi

Integritas Data & Legalitas Acuan

Seluruh data pada KodeKecil API bersumber dari acuan regulasi resmi Republik Indonesia tanpa modifikasi data sepihak:

  • Kalender Libur Nasional: SKB 3 Menteri (Menteri Agama, Menaker, MenPAN-RB) per tahun kalender.
  • Wilayah Provinsi: Permendagri No. 050-145 dan Kepmendagri 100.1.1-6117 pasca pemekaran 38 provinsi.
  • Standar QRIS: ASPI & Bank Indonesia Merchant Presented Mode (MPM) dengan validasi checksum polinomial CRC-16/CCITT-FALSE.
DOCS Pertanyaan Umum (FAQ) & Kepatuhan Regulasi

FAQ, Kebijakan Privasi, dan Tata Kelola Data

Panduan komprehensif mengenai kepatuhan hukum pelindungan data pribadi (UU PDP No. 27 Tahun 2022), arsitektur zero-retention, batas pemakaian (rate limit), kompatibilitas QRIS, dan ketentuan lisensi proyek open-source.

UU PDPBagaimana kepatuhan KodeKecil API terhadap UU Pelindungan Data Pribadi (UU PDP No. 27/2022)?

KodeKecil API menerapkan prinsip Privacy by Design dengan kebijakan Zero-Retention (tanpa penyimpanan data):

  • Tanpa Basis Data: Pemrosesan NIK berjalan murni di memori RAM V8 isolat Cloudflare Workers. Tidak ada database (SQL/NoSQL) atau media penyimpanan persisten yang menyimpan data pengguna.
  • Tanpa Pencatatan NIK: Sistem tidak pernah mencatat atau melog 16 digit angka NIK ke dalam sistem logging maupun telemetri edge.
  • Masking Otomatis: Setiap respons penguraian NIK otomatis menyertakan atribut nik_masked (contoh: 327301******0001) guna mendukung kepatuhan prinsip minimisasi data pada antarmuka aplikasi Anda.
PRIVASIMengapa metode POST lebih disarankan daripada GET untuk validasi NIK?

Meskipun metode GET /v1/id/nik?nik=... disediakan untuk kenyamanan pengujian cepat, kami sangat merekomendasikan metode POST /v1/id/nik pada aplikasi skala produksi:

  • Pada metode GET, nilai NIK dikirimkan melalui URL query parameter yang rentan tersimpan pada riwayat browser pengguna, log proxy perusahaan atau ISP, serta header HTTP Referer jika berpindah halaman.
  • Pada metode POST, nilai NIK dikirimkan di dalam request body JSON terenkripsi HTTPS over TLS 1.3, sehingga parameter identitas terlindungi penuh dari pencatatan log jaringan transit.
GRATISApakah KodeKecil API 100% gratis? Mengapa tanpa API Key?

Ya, seluruh endpoint KodeKecil API dapat diakses 100% gratis tanpa biaya langganan dan tanpa registrasi API key:

Proyek ini dirancang sebagai utilitas publik terbuka untuk memberdayakan ekosistem developer, startup, UMKM, dan komunitas teknologi di Indonesia. Infrastruktur dioptimalkan di atas jaringan Cloudflare Workers dengan konsumsi komputasi sub-10ms CPU time per request, sehingga efisiensi operasional sangat tinggi.

KUOTABerapa batasan pemakaian (Rate Limiting) yang diberlakukan?

Untuk menjamin keadilan akses (fair usage) dan mencegah serangan scraping atau bot abuse, diberlakukan batasan pemakaian:

  • 120 request per menit per alamat IP.
  • Setiap respons API menyertakan header standar: RateLimit-Limit, RateLimit-Remaining, dan RateLimit-Reset.
  • Jika kuota terlampaui, edge worker akan merespons dengan HTTP status 429 Too Many Requests beserta header Retry-After yang mengindikasikan waktu tunggu dalam detik.
LEGALDari mana sumber data resmi yang digunakan pada setiap API?

Integritas data merupakan prioritas utama. Seluruh data diselaraskan dengan rujukan otoritas negara Republik Indonesia:

  • Hari Libur & Cuti Bersama: Surat Keputusan Bersama (SKB) 3 Menteri (Menteri Agama, Menteri Ketenagakerjaan, dan Menteri PAN-RB) yang diperbarui setiap tahun kalender.
  • Wilayah Provinsi: Master wilayah Kementerian Dalam Negeri (Kemendagri) dan Badan Pusat Statistik (BPS), telah mencakup 38 provinsi pasca pemekaran Papua (Papua Selatan, Papua Tengah, Papua Pegunungan, dan Papua Barat Daya).
  • QRIS Decoder: Spesifikasi resmi Bank Indonesia (PADG No. 21/18/PADG/2019) dan Asosiasi Sistem Pembayaran Indonesia (ASPI) berbasis standar global EMVCo MPM TLV dengan validasi checksum CRC-16/CCITT-FALSE.
  • Kurs Valas: Data referensi nilai tukar harian terhadap Rupiah (IDR).
QRISApakah QRIS Decoder mendukung QRIS Dinamik dan seluruh penyedia PJP?

Ya. Algoritma decoder mematuhi spesifikasi EMVCo Tag-Length-Value (TLV):

  • Mendukung QRIS Statik (Tag 01: 11) dan QRIS Dinamik (Tag 01: 12).
  • Mengekstrak National Merchant ID (NMID), nama merchant, kota, kode pos, dan nilai transaksi yang telah diset pada QRIS Dinamik.
  • Kompatibel dengan seluruh QRIS terbitan Penyelenggara Jasa Pembayaran (PJP) berizin Bank Indonesia, termasuk BCA, Bank Mandiri, BRI, BNI, GoPay, OVO, Dana, LinkAja, ShopeePay, AstraPay, dan lainnya.
LISENSISiapa saja yang boleh menggunakan API ini? Apakah boleh untuk komersial?

KodeKecil API boleh digunakan secara bebas dan gratis oleh siapa saja, dengan syarat proyek yang menggunakannya berstatus open-source (sumber terbuka).

Jika proyek, repositori, atau aplikasi Anda bersifat open-source untuk publik, Anda bebas langsung mengintegrasikan API ini. Untuk aplikasi komersial tertutup (closed-source/proprietary), silakan lakukan self-host repositori ini secara mandiri di Cloudflare Workers milik organisasi Anda sendiri.

KEAMANANBagaimana langkah pelaporan celah keamanan atau saran fitur baru?

Kami menerapkan standar RFC 9116 Coordinated Vulnerability Disclosure:

  • Detail kontak keamanan dapat diakses pada endpoint /.well-known/security.txt.
  • Laporan keamanan, diskusi, dan saran penambahan endpoint baru dapat diajukan langsung melalui repository resmi di GitHub: github.com/vhmns14/kodekecil-api.