Base URL
Semua endpoint diakses dari base URL berikut:
curl -H "X-API-Key: YOUR_KEY" \
https://ntt.tanggap-bencana.go.id/api/v1/
Authentication
Semua endpoint butuh API key. Buat key di menu Manage User dengan SHA1 gate. Key dikirim via HTTP header (recommended) atau query string.
-H "X-API-Key: ntt_a1b2c3d4..."
?api_key=ntt_a1b2c3d4...
Endpoints
/api/v1/
Metadata API + daftar semua endpoint yang tersedia.
/api/v1/kabupaten
Daftar 7 kabupaten terdampak gempa NTT.
Lihat contoh response
{
"kabupaten": [
{
"id": 67,
"nama_kabupaten": "Sikka",
"nama_lengkap": "Kabupaten Sikka"
},
{
"id": 68,
"nama_kabupaten": "Manggarai Timur",
"nama_lengkap": "Kabupaten Manggarai Timur"
}
],
"meta": {
"count": 7,
"generated_at": "2026-08-19T12:00:00Z"
}
}
/api/v1/analisa
Data analisa ringkasan harian per kabupaten.
kabupaten_id=67
tanggal=2026-08-19
Lihat contoh response
{
"data": [
{
"id": 70,
"kabupaten_id": 67,
"kabupaten": "Sikka",
"tanggal": "2026-08-19",
"luka_ringan": 5,
"luka_berat": 0,
"meninggal": 0,
"pengungsi": 1240,
"rumah_rusak": 38
}
],
"meta": { "count": 1, "generated_at": "..." }
}
/api/v1/situasi
Situasi kesehatan & populasi terdampak.
kabupaten_id
tanggal
/api/v1/rs
Kondisi pasien rawat inap di Rumah Sakit (kategori: merah/kuning/hijau/hitam).
/api/v1/puskesmas
Kondisi pasien rawat jalan di Puskesmas (kategori: merah/kuning/hijau/hitam).
Query Filters
Semua endpoint data mendukung 2 filter opsional:
| Parameter | Tipe | Contoh | Keterangan |
|---|---|---|---|
kabupaten_id |
integer | 67 |
Filter per kabupaten (lihat /api/v1/kabupaten) |
tanggal |
date | 2026-08-19 |
Format YYYY-MM-DD. Exact match. |
Response Format
Setiap response JSON punya 2 key utama:
{
"data" : [ { "id": 1, "...": "..." } ], // atau "kabupaten"
"meta" : {
"count" : 7,
"generated_at": "2026-08-19T12:00:00+07:00",
"filters" : { "kabupaten_id": 67, "tanggal": "2026-08-19" }
}
}
Try It Live
Masukkan API key kamu lalu klik endpoint untuk test:
Belum punya key? Buat di Manage User (gate SHA1).
Error Codes
| HTTP | Error Code | Arti |
|---|---|---|
| 200 | — | Sukses |
| 401 | missing_api_key |
Header X-API-Key / query api_key tidak ada |
| 401 | invalid_api_key |
Key salah, sudah dihapus, atau dinonaktifkan |
| 404 | not_found |
Endpoint tidak ada |
| 500 | server_error |
Server error (hubungi admin) |
{
"error": "invalid_api_key",
"message": "API key tidak valid atau sudah dinonaktifkan."
}