Pengenalan API Terintegrasi SIGA

API Terintegrasi SIGA (Sistem Informasi Gender dan Anak) Provinsi Sulawesi Selatan dibangun untuk menjembatani pertukaran data sektoral antara aplikasi milik Kabupaten/Kota dengan server pusdalops Provinsi secara *real-time* dan aman.


Autentikasi

API Key Required

Seluruh endpoint di dalam API ini (kecuali dinyatakan lain) mewajibkan penyertaan *API Key* aktif yang diterbitkan oleh administrator Provinsi.

Kirimkan API Key Anda melalui HTTP Header Authorization dengan skema Bearer.

Authorization: Bearer YOUR_API_KEY_HERE
Accept: application/json

Cek Koneksi (Ping)

Endpoint ini digunakan untuk memverifikasi apakah kredensial API Key Anda valid dan sistem berhasil terhubung dengan server provinsi.

GET

/api/v1/ping

Response Sukses (200 OK)

{
    "status": true,
    "message": "Koneksi berhasil",
    "data": {
        "client": "Kab. Gowa",
        "timestamp": "2026-06-05 10:00:00"
    }
}

Metadata Master

Digunakan untuk menarik seluruh referensi metadata master (seperti daftar OPD, kategori urusan, dan definisi tabel standar provinsi) agar sistem di Kab/Kota dapat menyesuaikan struktur database lokalnya.

GET

/api/v1/metadata

Response Sukses (200 OK)

{
    "status": true,
    "data": {
        "opd": [ ... ],
        "urusan": [ ... ],
        "indikator": [ ... ]
    }
}

Bank Data Sektoral

Endpoint untuk membaca dan mensinkronisasikan data sektoral (bank data) yang sebelumnya telah dikirimkan ke Provinsi. Berguna jika sistem Kab/Kota perlu merekonstruksi ulang data riwayat pencapaian.

GET

/api/v1/dataset/bank

Query Parameters

ParameterTipeWajibDeskripsi
tahunIntegerYaTahun data sektoral yang diminta (contoh: 2026).
opd_guidStringTidakFilter spesifik per OPD berdasarkan GUID.

Kirim / Proses Data

Merupakan endpoint utama (*core*) tempat aplikasi Kab/Kota melakukan *push/update* nilai capaian indikator sektoral secara massal atau parsial ke server provinsi.

POST

/api/v1/dataset/process

Request Body (JSON)

{
    "tahun": 2026,
    "payload": [
        {
            "indikator_id": "IDK-001",
            "nilai": 14500,
            "sumber_data": "BPS Makassar"
        },
        {
            "indikator_id": "IDK-002",
            "nilai": 85.5,
            "sumber_data": "Dinas Kesehatan"
        }
    ]
}