N
NTT Gempa API
v1 · Public Read-Only
v1.0 REST · JSON No rate limit*

Dashboard Gempa NTT Public API

Akses data read-only untuk 7 kabupaten terdampak gempa NTT: analisa harian, situasi kesehatan, kondisi pasien RS, dan Puskesmas. Buat API key di menu Manage User untuk mulai.

7
Kabupaten
4
Tabel Data
GET
Read-Only
JSON
Response

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.

Header (recommended)
-H "X-API-Key: ntt_a1b2c3d4..."
Query String (fallback)
?api_key=ntt_a1b2c3d4...
⚠ Perhatian: Key hanya ditampilkan sekali saat dibuat. Disimpan sebagai SHA-256 hash di server. Kalau hilang, hapus & buat ulang.

Endpoints

GET /api/v1/
Public

Metadata API + daftar semua endpoint yang tersedia.

GET /api/v1/kabupaten
Auth required

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"
  }
}
GET /api/v1/analisa
Auth required

Data analisa ringkasan harian per kabupaten.

Filter
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": "..." }
}
GET /api/v1/situasi
Auth required

Situasi kesehatan & populasi terdampak.

Filter
kabupaten_id tanggal
GET /api/v1/rs
Auth required

Kondisi pasien rawat inap di Rumah Sakit (kategori: merah/kuning/hijau/hitam).

GET /api/v1/puskesmas
Auth required

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)
Contoh error response:
{
  "error": "invalid_api_key",
  "message": "API key tidak valid atau sudah dinonaktifkan."
}