Mulai cepat
Setiap sumber daya adalah berkas yang dibuat ulang setelah pipeline SIPAGA berjalan. Ambil dengan GET biasa; tidak ada parameter kueri, jadi penyaringan dilakukan di sisi Anda.
curl
curl -s https://sipaga.bontangtechnohub.com/api/v1/ringkasan.json
JavaScript (peramban atau Node 18+)
const res = await fetch("https://sipaga.bontangtechnohub.com/api/v1/kabupaten.json");
if (res.status === 429) {
const detik = Number(res.headers.get("Retry-After") ?? 60);
throw new Error(`Batas laju tercapai, coba lagi dalam ${detik} detik`);
}
const { meta, data } = await res.json();
for (const k of data) console.log(k.nama, k.nilai_tertinggi, k.kelas_tertinggi);
Python
import requests
r = requests.get("https://sipaga.bontangtechnohub.com/api/v1/titik-panas-24jam.geojson", timeout=30)
r.raise_for_status()
geo = r.json()
print(geo["metadata"]["jumlah"], "titik panas dalam 24 jam terakhir")
QGIS dan perangkat GIS lain
Pilih Layer → Add Layer → Add Vector Layer, sumber Protocol: HTTP(S), lalu tempel alamat https://sipaga.bontangtechnohub.com/api/v1/wilayah.geojson. Atribut setiap poligon sama dengan isi wilayah.json.
Contoh respons: ringkasan.json
Diambil dari data 28 September 2026 dan dipersingkat (tanda …). Nilainya berubah setiap pembaruan.
{
"meta": {
"versi_api": "1",
"diperbarui": "2026-09-28T12:49+08:00",
"dokumentasi": "https://sipaga.bontangtechnohub.com/api/",
"lisensi": {
"indeks": "CC BY 4.0 (dihitung dari data cuaca Open-Meteo, CC BY 4.0)",
"…": "…"
},
"atribusi": "Sumber: SIPAGA Kaltim, Bontang Techno Hub (https://sipaga.bontangtechnohub.com)",
"tanggal_data": "2026-09-28",
"titik_panas_diperbarui": "2026-09-28T15:05+08:00"
},
"data": {
"tanggal_data": "2026-09-28",
"luas_per_kelas_pct": {
"Rendah": 2.7,
"Sedang": 12.0,
"Tinggi": 32.2,
"Sangat Tinggi": 53.1
},
"kabupaten_terawan": {
"nama": "Kabupaten Paser",
"nilai": 296.0,
"kelas": "Sangat Tinggi",
"pct_tinggi_ke_atas": 100.0
},
"peringatan": {
"judul": "Kerawanan kebakaran tinggi meluas di Kalimantan Timur",
"isi": "Sekitar 53% luas daratan Kalimantan Timur berada pada kelas …",
"wilayah": [
"Kabupaten Paser",
"Kota Balikpapan",
"…"
]
},
"jumlah_petak": 194,
"jumlah_khg": 16,
"titik_panas_24jam": 646,
"batas_kelas": {
"Rendah": [
0,
75
],
"Sedang": [
76,
150
],
"Tinggi": [
151,
225
],
"Sangat Tinggi": [
226,
300
]
},
"metode": {
"nama": "KBDI",
"skala": [
0,
300
],
"keterangan": "Indeks Kekeringan Keetch-Byram yang diskalakan untuk gambut tropis; angka tinggi berarti lahan siap terbakar, bukan sedang terbakar."
}
}
}
Sumber daya
Semua jalur relatif terhadap https://sipaga.bontangtechnohub.com/api/v1. Jadwal dalam WITA. Ukuran adalah ukuran unduhan setelah kompresi gzip.
| Jalur | Isi | Pembaruan | Ukuran |
|---|---|---|---|
/ | Daftar sumber daya, waktu pembaruan, lisensi | tiap pembaruan | 1 KB |
/ringkasan.json | Sebaran luas per kelas, peringatan meluas, kab/kota paling rawan | tiap run model cuaca baru; titik panas saat ada deteksi baru | 1 KB |
/kabupaten.json | Sepuluh kab/kota: angka tertinggi, sebaran luas per kelas, titik panas 24 jam | tiap run model cuaca baru; titik panas saat ada deteksi baru | 1 KB |
/kabupaten.geojson | Batas kab/kota beserta atribut yang sama (GIS) | tiap run model cuaca baru; titik panas saat ada deteksi baru | 35 KB |
/kabupaten/{kode}.json | Satu kab/kota dan semua wilayah pantau di dalamnya | tiap run model cuaca baru; titik panas saat ada deteksi baru | 1 KB |
/wilayah.json | 210 wilayah pantau (16 KHG, 194 petak) dengan angka terkini | tiap run model cuaca baru; titik panas saat ada deteksi baru | 9 KB |
/wilayah.geojson | Poligon 210 wilayah beserta atributnya (GIS) | tiap run model cuaca baru; titik panas saat ada deteksi baru | 48 KB |
/wilayah/{id}.json | Satu wilayah dengan riwayat 90 hari dan prakiraan | tiap run model cuaca baru; titik panas saat ada deteksi baru | 1 KB |
/wilayah-riwayat.json | Riwayat dan prakiraan seluruh wilayah dalam satu berkas | tiap run model cuaca baru | 92 KB |
/titik-panas-24jam.geojson | Titik panas 24 jam, kepercayaan sedang dan tinggi | saat ada deteksi baru | 13 KB |
/titik-panas.geojson | Titik panas 7 hari, semua tingkat kepercayaan | saat ada deteksi baru | 147 KB |
/status.json | Kesegaran data: kapan indeks dihitung, run model cuaca yang dipakai, kapan titik panas terakhir dicek dan berubah | tiap 10 menit | 1 KB |
/openapi.json | Spesifikasi OpenAPI 3.1 | saat versi berubah | 5 KB |
{kode} adalah kode wilayah Kemendagri, misalnya 64.74 untuk Kota Bontang. {id} adalah id dari wilayah.json, misalnya khg-64-02-08-01. Akhiran .json boleh dihilangkan.
Butuh data banyak wilayah? Ambil satu berkas gabungan (wilayah.json atau wilayah-riwayat.json) alih-alih 210 berkas satu per satu; yang kedua akan terbentur batas laju.
Kamus data
Angka dan kelas kerawanan
nilai adalah Indeks Kekeringan Keetch-Byram (KBDI) yang diskalakan untuk gambut tropis, dari 0 (tanah jenuh air) sampai 300 (kering maksimum). Angka tinggi berarti lahan siap terbakar bila ada sumber api, bukan bahwa kebakaran sedang terjadi.
| kelas | Rentang nilai | Artinya |
|---|---|---|
Rendah | 0–75 | Lahan lembap; api sulit menyala dan menjalar |
Sedang | 76–150 | Permukaan mulai mengering |
Tinggi | 151–225 | Lahan kering; api menjalar cepat |
Sangat Tinggi | 226–300 | Gambut dapat terbakar di bawah permukaan |
Wilayah (wilayah.json, wilayah/{id}.json)
jeniskhg(Kesatuan Hidrologis Gambut, SK MenLHK 129/2017) ataupetak(petak grid 0,25°, sekitar 25 × 25 km).kabupaten- Kab/kota yang disentuh wilayah, dengan
luas_km2di dalam masing-masing; terluas lebih dahulu. lokasi- Titik di dalam wilayah tempat data cuaca diambil (
lat,lon, WGS 84). trennaik,turun, ataustabildibanding 7 hari sebelumnya, dengan ambang ±10 poin.hujan_7hari_mm,suhu_maks_c- Jumlah hujan 7 hari terakhir (mm) dan suhu maksimum hari data (°C).
hujan_12minggu_mm_per_hari- Rata-rata hujan harian 12 minggu terakhir. Di bawah 4 mm/hari kebakaran dan asap di Indonesia meningkat tajam; di atas 6 mm/hari jarang terjadi (Field dkk. 2016). Ambangnya ada di
ringkasan.json, kolomambang_hujan_12minggu. hujan_tahunan_normal_mm- Normal hujan tahunan 2020–2025, parameter R0 dalam rumus KBDI.
titik_panas_24jam- Titik panas 24 jam terakhir berkepercayaan sedang–tinggi di wilayah ini;
nullbila data titik panas sedang tidak tersedia. riwayat,prakiraan- Daftar
{tanggal, nilai, kelas}: 90 hari terakhir, lalu hari-hari berikutnya dari ramalan cuaca. Prakiraan makin tidak pasti untuk hari yang lebih jauh.
Titik panas (titik-panas*.geojson)
Setiap fitur adalah titik [bujur, lintang]. id stabil antar-pembaruan, sehingga bisa dipakai untuk membuang duplikat saat Anda menyimpan riwayat sendiri.
{
"type": "Feature",
"id": "fcab9fd547ef",
"geometry": {
"type": "Point",
"coordinates": [
116.3693,
-0.058
]
},
"properties": {
"waktu_utc": "2026-09-27T08:20:00Z",
"satelit": "MODIS",
"kepercayaan": "sedang",
"kabupaten_kode": "64.02",
"kabupaten": "Kabupaten Kutai Kartanegara",
"wilayah_id": "khg-64-02-01",
"di_dalam_khg": true
}
}
waktu_utc- Waktu deteksi satelit dalam UTC. Tambah 8 jam untuk WITA.
kepercayaanrendah,sedang, atautinggi. Pelaporan nasional memakai sedang dan tinggi.wilayah_id,di_dalam_khg- Wilayah pantau tempat titik jatuh; titik di atas KHG diberi
true. asalSiPongi+atauNASA FIRMS. SiPongi+ adalah sumber utama; NASA FIRMS melengkapi deteksi yang belum diterbitkan ulang SiPongi+ (biasanya 1–3 jam lebih cepat) dan satelit NOAA-21 yang tidak ada di SiPongi+.sumber_tetaptruebila titik jatuh di lokasi yang panas setiap tahun bukan karena kebakaran (tambang batu bara, suar gas dan industri), menurut arsip NASA FIRMS. Titik ini tetap disertakan, tetapi tidak dihitung dalam angka 24 jam dan tidak masuktitik-panas-24jam.geojson.
Pembaruan dan cache
- Indeks dihitung ulang setiap kali model cuaca ECMWF IFS punya run baru, sekitar 4 kali sehari. Titik panas dicek tiap 10 menit, tetapi berkasnya hanya berubah bila ada deteksi baru; sumbernya sendiri terbit 3,5–4,5 jam setelah satelit lewat.
- Untuk sinkronisasi, pantau
/status.json(kecil,Cache-Control: no-cache) tiap 5–10 menit, lalu unduh berkas lain hanya bilaindeks.dihitungatautitik_panas.berubahberubah. - Setiap respons membawa
ETagdanLast-Modified. Kirim kembali sebagaiIf-None-Match; bila berkas belum berubah, jawabannya304tanpa badan. Ini menghemat bandwidth, tetapi tetap dihitung dalam batas laju. - Berkas lain dikirim dengan
Cache-Control: public, max-age=300; mengambil lebih sering dari 5 menit tidak memberi data yang lebih baru. - Waktu pembuatan data ada di
meta.diperbarui(JSON) ataumetadata.diperbarui(GeoJSON), dengan zona+08:00. Sumber daya indeks yang juga memuattitik_panas_24jammenyertakantitik_panas_diperbarui, karena hitungan itu diperbarui tiap jam.
curl -s -o /dev/null -w "%{http_code}\n" \
-H 'If-None-Match: "ETag-dari-respons-sebelumnya"' \
https://sipaga.bontangtechnohub.com/api/v1/ringkasan.json
Batas laju
Setiap alamat IP boleh mengirim 60 permintaan per menit ke /api/v1/, dengan cadangan hingga 40 permintaan beruntun. Batas ini melindungi server yang juga melayani situs lain, bukan membatasi pemakaian wajar.
- Bila terlampaui, jawabannya
429 Too Many Requestsdengan headerRetry-After: 60dan badan galat JSON. Tunggu selama itu sebelum mencoba lagi. - Kebijakan dinyatakan di header
RateLimit-Policy: "api";q=60;w=60(draf IETF RateLimit headers). - Untuk sinkronisasi terjadwal, satu atau dua permintaan per sumber daya per jam sudah cukup.
Galat
Galat dari API selalu JSON dengan bentuk yang sama:
{ "galat": { "kode": 404, "pesan": "Sumber daya tidak ditemukan. Lihat daftar di /api/v1/.", "dokumentasi": "https://sipaga.bontangtechnohub.com/api/" } }
| Kode | Artinya |
|---|---|
304 | Berkas belum berubah sejak ETag yang Anda kirim. |
404 | Jalur atau id tidak ada. Periksa daftar di /api/v1/. |
405 | Metode selain GET, HEAD, atau OPTIONS. API ini hanya-baca. |
429 | Batas laju terlampaui; lihat Retry-After. |
Keamanan dan CORS
- API ini hanya-baca dan tidak memakai kunci, cookie, atau sesi. Tidak ada data pribadi di dalamnya.
- CORS terbuka untuk semua asal (
Access-Control-Allow-Origin: *), jadi halaman web mana pun dapat membacanya langsung dari peramban. - Hanya HTTPS. HSTS aktif, dan respons API membawa
X-Content-Type-Options: nosniffserta CSP yang menolak semua konten aktif. - Menemukan celah keamanan? Laporkan secara pribadi melalui kontak di
/.well-known/security.txt, bukan di tempat umum.
Versi dan perubahan
- Versi saat ini adalah v1, tertulis di jalur (
/api/v1/) dan dimeta.versi_api. - Di dalam v1, bidang baru dapat ditambahkan tanpa pemberitahuan. Aplikasi Anda sebaiknya mengabaikan bidang yang tidak dikenal.
- Perubahan yang merusak — mengganti nama, menghapus bidang, atau mengubah artinya — hanya dilakukan di versi baru (
/api/v2/). Versi lama tetap berjalan paling sedikit 90 hari setelah pengumuman di halaman ini.
Lisensi dan atribusi
Indeks kerawanan SIPAGA dilisensikan CC BY 4.0: bebas dipakai, dibagikan, dan diolah, termasuk untuk tujuan komersial, dengan menyebut sumbernya. Data dari pihak lain tetap mengikuti ketentuan sumber aslinya:
- Titik panas: SiPongi+ Kementerian Kehutanan; cadangan NASA FIRMS.
- Batas KHG: JIGD Kalimantan Timur (SK MenLHK 129/2017).
- Batas kab/kota: geoBoundaries, CC BY 3.0 IGO.
- Data cuaca yang menjadi masukan indeks: Open-Meteo, CC BY 4.0.
Cantumkan teks dari meta.atribusi, misalnya:
Sumber: SIPAGA Kaltim, Bontang Techno Hub (https://sipaga.bontangtechnohub.com)
Batasan data
- SIPAGA Kaltim bukan produk resmi BMKG maupun Kementerian Kehutanan. Untuk peringatan resmi, rujuk BMKG dan SiPongi+.
- Angka dihitung dengan KBDI. Versi khusus gambut (PFVI) memerlukan data tinggi muka air tanah yang belum tersedia secara terbuka untuk Kalimantan Timur.
- Titik panas adalah indikasi dari satelit dan perlu verifikasi lapangan. Satu kebakaran dapat terdeteksi oleh beberapa satelit sekaligus.
- Tidak ada jaminan ketersediaan. Untuk keputusan keselamatan, jangan bergantung pada satu sumber.