ApiTerasKotaMagelang/DOKUMENTASI_API.md

Berikut adalah rangkuman teknis dokumentasi API Teraskota Magelang (Ora Ribet v2) yang disusun untuk kebutuhan pengembang (developer). Dokumentasi ini mencakup standar autentikasi, format request, dan daftar endpoint yang tersedia berdasarkan dokumen yang Anda unggah.

---

Dokumentasi API Teraskota Magelang (Ora Ribet v2)

1. Ikhtisar Umum

API ini menggunakan arsitektur REST dengan komunikasi via HTTP dan format pertukaran data menggunakan JSON[cite: 3].

• Base URL: https://api.integrasvc.id (Berdasarkan URL pada endpoint)
• Content-Type: application/json

2. Autentikasi (Security)

Setiap permintaan (request) ke API wajib menyertakan kredensial keamanan di dalam Header.

• Metode: Basic Authentication[cite: 6].
• Mekanisme: Mengirimkan username dan password yang telah dikodekan (encoded) dalam header setiap request.
• Catatan: Kredensial (User & Password) diberikan terpisah dari dokumen teknis ini dan wajib dijaga kerahasiaannya oleh client[cite: 7, 8].
• Access Token: Dokumen juga menyebutkan aplikasi client harus menyertakan access token pada header, pastikan untuk mengecek apakah ini token statis atau dinamis bersamaan dengan Basic Auth[cite: 4].

---

3. Daftar Endpoint

A. List Target Bantuan

Mengambil daftar program bantuan yang tersedia.

• URL: https://api.integrasvc.id/pbn3z [cite: 10]
• Method: POST [cite: 10]
• Header: Authorization: Basic <credentials>
• Body Parameters: (Tidak disebutkan spesifik di dokumen, asumsikan kosong atau sesuai kebutuhan filter standar)

Contoh Response:

{
  "success": true,
  "total": 6,
  "result": [
    {
      "program": "Bantuan Bahan Bangunan Rumah...",
      "sasaran": "Perorangan/Keluarga",
      "is_active": 1,
      "icon": "pencil_443255.png"
    },
    {
       "program": "...",
       "sasaran": "...",
       "is_active": 1,
       "icon": "..."
    }
  ]
}

[cite: 10]

---

B. Detail Data Target Bantuan

Menampilkan detail data penerima atau target dari jenis bantuan tertentu.

• URL: https://api.integrasvc.id/qv2k9 [cite: 13]
• Method: POST [cite: 14]
• Header: Authorization: Basic <credentials>

Body Parameters:

Parameter	Tipe Data	Keterangan
id	Integer	ID Bantuan [cite: 16]
id_kec	String	ID Kecamatan [cite: 17, 18]
id_kel	String	ID Kelurahan [cite: 19, 20]
rw	String	Nomor RW [cite: 21, 22]
rt	String	Nomor RT [cite: 23, 24]
start	String	Posisi awal data (Pagination) [cite: 25, 26]
limit	String	Batas jumlah data (Pagination) [cite: 27, 28]

Contoh Response:

{
  "success": true,
  "result": {
    "data": [
      {
        "nik": "3371014012870002",
        "nama": "Firza Nurlita...",
        "provinsi": "JAWA TENGAH",
        "kabupaten": "KOTA MAGELANG",
        "kecamatan": "MAGELANG SELATAN",
        "kelurahan": "REJOWINANGUN SELATAN",
        "alamat": "Paten Tegal...",
        "rw": "006",
        "rt": "003"
      }
    ]
  }
}

[cite: 30, 31, 44-53]

---

C. Profil Rekap RT

Menampilkan data statistik atau profil rekapitulasi untuk tingkat RT berdasarkan kategori tertentu.

• URL: https://api.integrasvc.id/pd32v [cite: 57]
• Method: POST [cite: 60]
• Header: Authorization: Basic <credentials>

Body Parameters:

Parameter	Tipe Data	Keterangan
mode	String	Pilihan mode profil. Opsi: perumahan, individu, aset, rtlh [cite: 61, 87-90]
id_kec	Integer	ID Kecamatan [cite: 63, 64]
id_kel	String	ID Kelurahan [cite: 65, 66]
rw	String	Nomor RW [cite: 67, 68]
rt	String	Nomor RT [cite: 69, 70]

Contoh Response:

{
  "success": true,
  "result": {
    "val_ruta": 24276,
    "val_kk": 25516,
    "val_jiwa": 66268,
    "val_draf": 0,
    "val_verify": 0,
    "val_tolak": 0,
    "val_verified": 24276,
    "dtakec": [
      {
        "name": "MAGELANG SELATAN",
        "y": 11423
      },
      {
        "name": "MAGELANG TENGAH",
        "y": 12536
      },
      {
        "name": "MAGELANG UTARA",
        "y": 10169
      }
    ]
  }
}

[cite: 75-86, 91, 102-104]

---

Catatan Tambahan untuk Developer

1. Format Parameter: Perhatikan tipe data (Integer vs String) pada setiap parameter di atas untuk menghindari kesalahan Bad Request.
2. Pagination: Endpoint Detail Data Target Bantuan mendukung pagination menggunakan parameter start dan limit.
3. Mode Profil: Pastikan parameter mode pada endpoint Profil Rekap RT diisi salah satu dari: perumahan, individu, aset, atau rtlh agar data yang keluar sesuai konteks.