Pusat Bantuan & Dokumentasi API

Panduan lengkap penggunaan Portal Satu Data Kabupaten Banggai Kepulauan, termasuk cara mengintegrasikan dataset ke dalam sistem aplikasi Anda melalui REST API.

Pengantar

Selamat datang di Pusat Bantuan Portal Satu Data Kabupaten Banggai Kepulauan. Halaman ini disusun untuk membantu masyarakat umum dalam mengakses dan mengunduh data, serta membantu para pengembang (developer) dalam mengintegrasikan data kami secara terprogram melalui REST API.

Panduan Penggunaan Portal

Cara Mencari Data

Gunakan kotak pencarian di halaman utama atau navigasi melalui menu Dataset. Anda dapat memfilter data berdasarkan Instansi (OPD), Kategori, atau Format File.

Mengunduh Format Raw

Di setiap halaman detail dataset, tersedia tombol unduh (Download). Tersedia format Excel (.xlsx), CSV, maupun dokumen statis PDF jika disediakan oleh OPD.

REST API: Otentikasi & Rate Limit

Portal Satu Data menyediakan REST API publik yang mengembalikan balasan dalam format JSON. Saat ini, metode HTTP GET untuk mengambil data dapat diakses tanpa memerlukan API Key (Public Access).

Rate Limit: Untuk menjaga stabilitas server, akses dibatasi maksimal 60 request per menit per IP Address. Jika melewati batas, Anda akan menerima status kode 429 Too Many Requests.

Base URL API:

https://satudata.banggaikep.go.id/api/v1

Mengambil Daftar Dataset

Endpoint ini digunakan untuk menarik daftar dataset yang sudah berstatus Published. Anda dapat menggunakan parameter untuk melakukan filter.

GET /dataset

Parameter (Opsional):

Parameter Tipe Deskripsi
cari String Kata kunci pencarian judul data.
instansi_id Integer ID instansi atau dinas terkait.
limit Integer Jumlah data per halaman (Default: 10).

Contoh Respons JSON (200 OK):

Response 
{
  "success": true,
  "message": "Data berhasil diambil",
  "data": [
    {
      "id": 1,
      "judul": "Data Jumlah Penduduk Miskin",
      "slug": "data-jumlah-penduduk-miskin",
      "tahun_data": 2026,
      "instansi": {
        "id": 5,
        "nama": "Dinas Sosial"
      }
    }
  ],
  "pagination": {
    "current_page": 1,
    "total_pages": 5
  }
}

Tanya Jawab (FAQ)

Apakah data yang disajikan gratis untuk digunakan?

Ya, seluruh dataset yang berstatus Published (Open Data) di dalam portal ini bebas diakses, diunduh, dan diolah kembali oleh publik maupun akademisi secara gratis, dengan tetap mencantumkan sumber.

Bagaimana jika data yang saya cari tidak ditemukan?

Jika data spesifik dari suatu instansi tidak tersedia, Anda dapat mengajukan permohonan informasi melalui fitur Hubungi Wali Data atau langsung menghubungi Pejabat Pengelola Informasi dan Dokumentasi (PPID) Kabupaten Banggai Kepulauan.

Bisakah saya membangun aplikasi desa terintegrasi dari API ini?

Sangat bisa! API ini memang dirancang untuk menunjang program digitalisasi daerah, termasuk untuk ditarik ke dalam dashboard desa atau sistem informasi terpadu lainnya.

Butuh Bantuan Lebih Lanjut?

Tim Wali Data (Dinas Komunikasi dan Informatika) Kabupaten Banggai Kepulauan siap membantu Anda terkait kendala teknis atau permohonan integrasi data.

Email Dukungan Teknis