REST API Publik

API Data Satu Data Bone

Akses metadata dataset, statistik, visualisasi, infografik, dan peta publik dalam format JSON. Endpoint metadata menggunakan metode GET. Permintaan unduhan Mapset menggunakan POST dan mencatat informasi penggunaan data.

Unduh Postman Collection

Import file JSON ke Postman, lalu isi collection variables untuk mencoba endpoint detail.

Base URL

https://satudata.bone.go.id

Data publik terverifikasi. API hanya menampilkan konten yang telah disetujui. Dataset dengan visibility nonpublik tidak ditampilkan.

Dataset

Metadata dataset yang telah divalidasi dan ditandai untuk tampil ke publik.

GET /apiv1/frontend/dataset-list

GET /apiv1/frontend/dataset-view?id_dataset={id_dataset}

GET /apiv1/frontend/dataset-data?id_dataset={id_dataset} Urutan kolom dan isi tabel

Parameter daftar: q, topik, organisasi, page, per_page

Statistik

Kegiatan statistik dari portal statistik yang telah disetujui, termasuk variabel dan indikatornya.

GET /apiv1/frontend/statistik-list

GET /apiv1/frontend/statistik-view?id={id_statistik}

Parameter daftar: q, jenis, sektor, produsen, page, per_page

Visualisasi

Daftar dan detail visualisasi yang telah divalidasi.

GET /apiv1/frontend/visualisasi-list

GET /apiv1/frontend/visualisasi-view?id_visualisasi={id_visualisasi}

Parameter daftar: q, author, kategori, page, per_page

Infografik

Daftar dan detail infografik yang telah divalidasi.

GET /apiv1/frontend/infografik-list

GET /apiv1/frontend/infografik-view?id_infografik={id_infografik}

Parameter daftar: q, author, page, per_page

Peta (Mapset)

Metadata kumpulan peta tematik dengan status publik aktif.

GET /apiv1/frontend/mapset-list

GET /apiv1/frontend/mapset-view?id_mapset={id_mapset}

POST /apiv1/frontend/mapset-download-request Permintaan unduh SHP + SLD

Parameter daftar: q, organisasi, page, per_page

Unduh berkas

Detail dataset, visualisasi, dan infografik memiliki properti files. Gunakan download_url untuk mengunduh berkas, bukan menyusun URL dari nama file.

GET /apiv1/frontend/file-download?id={id_file}

{
  "files": [
    {
      "id": 25,
      "title": "Data Penduduk 2026",
      "description": "Berkas dataset",
      "filename": "data_penduduk_2026.xlsx",
      "extension": "xlsx",
      "download_url": "https://satudata.bone.go.id/apiv1/frontend/file-download?id=25"
    }
  ]
}

URL hanya dapat mengunduh berkas yang induknya sudah tersedia untuk publik. ID yang tidak valid, file yang hilang, atau konten yang belum disetujui akan menghasilkan response 404.

Unduh Mapset SHP + SLD

Mapset tidak memakai endpoint unduh file umum. Kirim data permintaan terlebih dahulu, lalu gunakan URL bertoken yang dikembalikan API.

POST /apiv1/frontend/mapset-download-request

Form data

id_mapset={id_mapset}
nama=Nama pengguna
instansi=Nama instansi
email=nama@example.go.id
wa_telp=08123456789
tujuan=Tujuan penggunaan data
setuju=1

Response berhasil

{
  "success": true,
  "message": "Permintaan download berhasil disimpan.",
  "download_url": "https://satudata.bone.go.id/portal/download-mapset-bundle?token=...",
  "expires_at": "2026-07-24T10:00:00+08:00"
}

Tautan berlaku selama 24 jam dan hanya dapat digunakan satu kali. File ZIP hasil unduhan berisi arsip shapefile beserta SLD yang tersedia.

Contoh permintaan

curl "https://satudata.bone.go.id/apiv1/frontend/dataset-list?q=penduduk&page=1&per_page=10"

Pagination

Endpoint daftar mengembalikan informasi halaman bersama koleksi data:

{
  "page": 1,
  "per_page": 10,
  "total": 125,
  "items": []
}

Status response

HTTP status	Keterangan
`200`	Permintaan berhasil.
`404`	Data tidak ditemukan atau belum tersedia untuk publik.
`405`	Metode HTTP tidak sesuai dengan endpoint yang dipanggil.
`422`	Data permintaan unduhan Mapset belum lengkap atau tidak valid.
`500`	Terjadi gangguan pada layanan.