API Documentation
Selamat datang di portal pengembang Satrup ISB. Open Data API kami dirancang untuk memberikan akses transparan dan mudah terhadap data pengadaan barang/jasa publik (Inaproc) yang telah dinaturalisasi dan diagregasi.
Core Principles
- Naturalized: Field data diseragamkan antar modul (RUP, Tender, E-Katalog).
- Aggregated: Data disajikan dalam bentuk ringkasan per Satuan Kerja (SKPD).
- Real-time Sync: Data selalu merujuk pada hasil sinkronisasi crawler terbaru.
Authentication
Saat ini, Open Data API dapat diakses secara publik tanpa memerlukan token otentikasi untuk memfasilitasi keterbukaan data. Namun, kami membatasi penggunaan melalui Rate Limiting untuk menjaga performa server.
Base URL
Semua request API harus diarahkan ke URL berikut:
https://satrup.tanahlautkab.go.id/api/open
/skpd
Endpoint ini digunakan untuk mengambil data master SKPD (Satuan Kerja Perangkat Daerah) yang sudah dinaturalisasi kodenya sehingga konsisten di seluruh modul data.
Query Parameters
| Parameter | Description |
|---|---|
| tahun | Tahun data (default: tahun berjalan). Contoh: 2026. |
/snapshots/{module}/{type}
Endpoint ini digunakan untuk menemukan daftar tanggal (snapshots) kapan data pengadaan tertentu disinkronisasi oleh sistem.
Path Parameters
| Parameter | Description |
|---|---|
| module | Kategori modul (contoh: rup, tender). |
| type | Jenis data (contoh: penyedia, nilai-selesai). |
/agregat-by-skpd/{module}/{type}
Mendapatkan data agregat nilai pengadaan per SKPD.
| Parameter | Description |
|---|---|
| tahun | Tahun data yang diinginkan (default: tahun berjalan). |
| tanggal | NEW Snapshot tanggal spesifik (format: YYYY-MM-DD). Sistem akan mengambil snapshot terbaru yang ada pada atau sebelum tanggal ini. |
| snapshot | ID Snapshot spesifik (contoh: 20260414_025136). Jika diisi, parameter tanggal akan diabaikan. |
/agregat-by-jenis/{module}/{type}
Mendapatkan data agregat nilai pengadaan berdasarkan Jenis Pengadaan.
/agregat-by-metode/{module}/{type}
Mendapatkan data agregat nilai pengadaan berdasarkan Metode Pemilihan.
/moner
Endpoint khusus untuk mendapatkan data Realisasi RUP (Moner) yang sudah diagregasi per SKPD secara otomatis dari sistem SIRUP.
Query Parameters
| Parameter | Description |
|---|---|
| tahun | Tahun data (default: tahun berjalan). |
| tanggal | (Optional) Snapshot tanggal spesifik (YYYYMMDD). |
/carirup
Endpoint fungsional untuk melakukan pengecekan detail paket RUP secara mendalam berdasarkan Kode RUP (ID Paket). Sistem ini menggunakan kecerdasan buatan sederhana untuk menentukan sumber data:
- Cache Lokal: Mencari di database snapshot Satrup (Sangat Cepat).
- Live Scraping: Jika tidak ditemukan di lokal, sistem akan melakukan real-time fetching langsung ke server SIRUP LKPP (Akurat).
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| idPaket | Required | Kode RUP / ID Paket Penyedia (contoh: 62147589). |
| save | Optional | Boolean (default: true). Jika true, hasil pencarian akan disimpan ke cache publik untuk mempercepat pencarian berikutnya. |
Sample Response
{
"status": "success",
"source": "Live Scraping (SIRUP)",
"data": {
"kode_rup": "62147589",
"nama_paket": "Pengadaan Laptop Operasional",
"pagu": 150000000,
"metode": "E-Purchasing",
"satker": "Dinas Komunikasi dan Informatika",
"tahun": 2026
}
}
/v1/{module}/{type}
Endpoint ini digunakan untuk mengambil data asli (raw) yang telah dinaturalisasi format field-nya namun belum diagregasi. Berguna untuk analisis mendalam per paket data.
Pagination & Limits
Secara default, endpoint ini mengembalikan maksimal 1000 record terbaru untuk menjaga performa. Gunakan parameter tahun untuk memfilter data per periode.
Query Parameters
| Parameter | Description |
|---|---|
| tahun | Tahun data (default: tahun berjalan). |
| tanggal | NEW Snapshot tanggal spesifik (format: YYYY-MM-DD). |
Module Mapping
Daftar kombinasi module dan type yang didukung:
| Module | Supported Types |
|---|---|
| RUP |
penyedia
swakelola
program
kegiatan
subkegiatan
|
| TENDER |
pengumuman
selesai
ekontrak
|
| NON-TENDER |
pengumuman
selesai
ekontrak
pencatatan
realisasi
|
| SWAKELOLA |
pencatatan
realisasi
|
| EKATALOG |
e-purchasing
archive
|
Response Structure
Setiap respon API agregasi memiliki struktur standar yang mencakup metadata untuk transparansi data dan data untuk hasil perhitungan.
Metadata Object
| Property | Type | Description |
|---|---|---|
| module | string | Nama modul data. |
| type | string | Tipe data (pengumuman, selesai, dll). |
| field_mapping | object | Daftar field JSON asli yang dipetakan ke sistem. |
| last_sync | string | Waktu sinkronisasi data terakhir. |
Data Object (Record)
Objek di dalam array data merepresentasikan ringkasan per SKPD:
| Property | Type | Description |
|---|---|---|
| kd_satker | string | Kode unik SKPD (hasil naturalisasi). |
| nama_satker | string | Nama lengkap SKPD. |
| total_amount | float | Total nilai (berdasarkan field mapping). |
| umkm_amount | float | Nilai porsi UMKM/PDN. |
Live Playground
Gunakan debugger interaktif di bawah ini untuk mencoba API secara langsung dengan data real-time.
Debugger Controls
FullscreenKlik tombol jalankan...