Dokumentasi API - Satu Data Lombok Tengah

API Publik

Integrasi SDI

Katalog metadata dataset berformat DCAT tanpa token.

API Mitra

Integrasi PELITA

List dan detail dataset dengan filter, pagination, serta Bearer token.

Dokumentasi terpisah

API Integrasi SDI

Ringkasan SDI

API ini menyediakan satu endpoint untuk mengambil seluruh daftar dataset yang berstatus dipublikasikan pada portal Satu Data Kabupaten Lombok Tengah. Respons berupa JSON dan dapat dipakai untuk integrasi portal lain, visualisasi, atau riset terbuka.

Endpoint

GET https://satudata.lomboktengahkab.go.id/api/dataset.json

Tidak memerlukan kunci API. Hanya dataset dengan flag_release = published yang dikembalikan.

Buka JSON di tab baru Pusat bantuan

Struktur respons

Akar dokumen adalah objek katalog DCAT. Properti dataset berisi larik objek dataset; tiap entri menyertakan metadata seperti judul, deskripsi, pengelola, kata kunci, tautan halaman portal, dan distribusi unduhan.

@type — dcat:Catalog pada akar, dcat:Dataset per item
dataset[] — daftar dataset publik
dataset[].identifier — pengenal stabil dataset
dataset[].landingPage — URL halaman detail di portal web
dataset[].distribution[].downloadURL — URL unduhan berkas data
conformsTo — referensi skema Project Open Data

Contoh permintaan

cURL

curl -sS -H "Accept: application/json" "https://satudata.lomboktengahkab.go.id/api/dataset.json"

JavaScript (fetch)

const url = "https://satudata.lomboktengahkab.go.id/api/dataset.json";
const res = await fetch(url, { headers: { Accept: "application/json" } });
const catalog = await res.json();
console.log(catalog.dataset?.length);

Unduhan berkas data

Field distribution[].downloadURL mengarah ke endpoint unduhan portal (misalnya CSV). Penggunaan data tetap mengikuti ketentuan lisensi dan ketentuan penggunaan yang berlaku untuk masing-masing dataset.

Catatan teknis

Format dan field dapat dikembangkan seiring kebutuhan; periksa tanggal pembaruan halaman ini atau kontak pengelola.
Akses dari aplikasi web di domain lain (CORS) mengikuti pengaturan server; jika mengalami blokir peramban, konsultasikan dengan tim infrastruktur.
Pemakaian wajar disarankan agar layanan tetap stabil untuk seluruh pengguna.

Dokumentasi terpisah

API Integrasi PELITA

Ringkasan PELITA

API PELITA menyediakan endpoint daftar dataset dan detail dataset. Hanya dataset dengan status publikasi dan workflow published yang dikembalikan. Tahun tersembunyi serta dataset atau field berklasifikasi terbatas/tertutup tidak dikirim.

List Dataset

https://satudata.lomboktengahkab.go.id/api/v1/dataset

Detail Dataset

https://satudata.lomboktengahkab.go.id/api/v1/dataset/{uuid}

Autentikasi PELITA

Setiap permintaan wajib mengirim Bearer token yang diberikan oleh pengelola portal. Token asli tidak ditampilkan pada halaman ini dan tidak boleh dimasukkan ke source code aplikasi klien.

Authorization: Bearer TOKEN_PELITA
Accept: application/json

List Dataset

GEThttps://satudata.lomboktengahkab.go.id/api/v1/dataset

Parameter	Tipe	Keterangan
`page`	integer	Halaman, default 1
`page_size`	integer	Jumlah item, default 25 dan maksimum 100
`tahun`	integer	Tahun data
`kode_provinsi`	string	Kode provinsi
`kode_kab_kota`	string	Kode kabupaten/kota
`kode_bidang_urusan`	string	Kode bidang urusan

Contoh cURL

curl -H "Authorization: Bearer TOKEN_PELITA" \
  -H "Accept: application/json" \
  "https://satudata.lomboktengahkab.go.id/api/v1/dataset?page=1&page_size=25&tahun=2026"

Detail Dataset

GEThttps://satudata.lomboktengahkab.go.id/api/v1/dataset/{uuid}

Ganti {uuid} dengan field id dari respons list. Parameter opsionalnya adalah page, page_size, dan tahun. Respons berisi metadata, definisi field, dan baris data.

{
  "message": "Berhasil",
  "code": 200,
  "metadata": { "total_data": 25, "total_page": 1, "page": 1, "page_size": 25 },
  "field": [{ "name_field": "tahun", "data_type": "integer", "length": 4, "klasifikasi_data": "terbuka" }],
  "data": [{ "tahun": 2026 }]
}

Status Respons PELITA

200Berhasil

400Parameter tidak valid

401Token tidak valid atau kedaluwarsa

404Dataset tidak ditemukan

429Terlalu banyak permintaan

500Kesalahan internal server

502Layanan PELITA belum aktif

Cara Testing PELITA

Dapatkan token dari pengelola API.
Kirim request list dengan header Bearer token.
Ambil nilai id dari datalist.
Gunakan ID tersebut pada endpoint detail.
Uji tanpa token untuk memastikan server mengembalikan HTTP 401.
Uji page=0 untuk memastikan validasi mengembalikan HTTP 400.

Beranda Jelajahi dataset