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:**

```json
{
  "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:**

```json
{
  "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:**

```json
{
  "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.