Portal Data Resmi Pemerintah Kabupaten Buton

Integrasi Data & API Publik

DataHUB Kabupaten Buton berperan sebagai simpul integrasi: satu pintu pertukaran data antar aplikasi OPD, menuju Satu Data Indonesia melalui Sistem Pelayanan Perizinan Berusaha dan infrastruktur SPBE nasional.

● Terhubung Status simpul SPLP
BUT-KAB-001 ID simpul data
— Sinkronisasi terakhir
REST · SPBE Data Exchange Protokol pertukaran
Arsitektur Interoperabilitas

Bagaimana data berpindah

Dokumentasi API lengkap
Aplikasi OPD

SIMPEG, SIKADA, SIMRS, dan sistem layanan perangkat daerah.

API Gateway DataHUB

Otentikasi kunci API, pembatas laju, dan pencatatan pemakaian.

DataHUB Kabupaten Buton

Katalog, metadata, validasi Walidata, dan API publik v1.

Simpul SPLP / Satu Data Indonesia

Pertukaran data ke tingkat provinsi dan nasional.

Seluruh permintaan API diamankan dengan HTTPS, pembatas laju per IP, dan kunci API opsional berbasis SHA-256. Kunci asli hanya ditampilkan satu kali saat diterbitkan — basis data hanya menyimpan ringkasannya.

Kunci API

Tiga langkah memperoleh akses resmi

1

Ajukan permohonan

Kirim permohonan melalui halaman kontak dengan subjek “Permohonan Kunci API”, sertakan nama OPD, sistem yang akan terhubung, dan tujuan pemakaian.

2

Verifikasi pengelola

Tim Satu Data memeriksa kebutuhan dan lingkup data yang diakses. Pengelolaan kunci dilakukan pada menu Kunci API di panel pengelola.

3

Kunci diterbitkan

Kunci berformat dhk_… disampaikan satu kali. Simpan pada penyimpanan rahasia sistem Anda; bila hilang, kunci lama dapat dinonaktifkan dan diganti.

Batas laju

Klien anonim (tanpa kunci)
120 permintaan / menit / IP
Pemegang kunci API
600 permintaan / menit / kunci
Respons melebihi batas
429 Too Many Requests beserta header Retry-After
Kunci tidak sah
401 Unauthorized

Contoh pemakaian

curl -H "X-API-Key: dhk_xxxxxxxx" "https://satudata.butonkab.go.id/api/v1/datasets?topik=kependudukan"

Kunci juga dapat dikirim melalui header Authorization: Bearer … atau parameter ?api_key=….

Endpoint Publik

Tersedia tanpa biaya, terbuka untuk siapa saja

Metode Path Keterangan
GET /api/v1/datasets Katalog dataset dengan filter topik, OPD, akses, dan tahun.
GET /api/v1/datasets/{slug} Detail dataset: metadata, variabel, berkas, dan cuplikan data.
GET /api/v1/categories Daftar topik/kategori data Satu Data Indonesia.
GET /api/v1/organizations Daftar produsen data / perangkat daerah.
GET /api/v1/indicators Registri indikator pembangunan daerah beserta nilai terakhir.
GET /api/v1/indicators/{slug} Deret nilai indikator per periode dan capaian target.
GET /api/v1/reference-codes Kode referensi & data induk beserta dataset pemanfaat.
GET /api/v1/quality Skor kualitas metadata seluruh dataset terpublikasi.
GET /api/v1/stats Ringkasan angka portal.
GET /api/v1/news Berita dan warta data terbaru.

Semua endpoint mengembalikan JSON dengan format { "success": true, "data": …, "meta": … }. Dokumentasi lebih rinci tersedia pada halaman dokumentasi API, dan katalog data mentah dapat dijelajahi melalui katalog dataset.

Katalog Terstruktur & Notifikasi

Untuk agregator & simpul SPLP

Katalog DCAT-AP

Katalog seluruh dataset dalam standar DCAT-AP untuk proses harvesting oleh agregator (mis. Satu Data Indonesia / simpul SPLP).

Webhook Perubahan Data

Alih-alih mengambil berkala (pull), sistem Anda dapat menerima pemberitahuan langsung (push) saat dataset diterbitkan/diperbarui.

Peristiwa
dataset.published, dataset.updated, proposal.published
Metode
POST JSON
Keamanan
Tanda tangan X-DataHUB-Signature (HMAC-SHA256)

Pendaftaran & pengujian webhook dilakukan pengelola melalui panel admin (menu Webhook).