Pusat Dokumentasi Developer & API REST API V1 Ready

Dokumentasi Sistem & REST API Mobile

Panduan integrasi REST API Android / Mobile Client, download Postman Collection v2.1, serta dokumentasi baku komponen antarmuka web sistem UPAB Pesantren Ulul Albab Cabang 3.

Postman Collection v2.1.0

Koleksi endpoint terstruktur lengkap dengan header, variable, body schema, dan contoh respons JSON.

Download Collection (.json) Raw JSON URL

Import Langsung via Link di Postman:

https://www.ula-water.epraja.net/api/v1/postman-collection

Base URL Endpoint

https://www.ula-water.epraja.net/api/v1

Seluruh endpoint REST API menggunakan awalan /api/v1/.

Metode Autentikasi

Bearer Token (Laravel Sanctum)

Gunakan header Authorization: Bearer {token} pada endpoint yang diproteksi.

Daftar Lengkap Endpoint REST API

Ringkasan rute, metode HTTP, parameter, dan status proteksi token.

1. Autentikasi & Akun Pelanggan

POST /api/v1/auth/login Publik

Body: { login, password, device_name }

POST /api/v1/auth/activate Publik

Aktivasi akun mandiri warga terdaftar dengan nomor sambungan.

POST /api/v1/auth/register Publik

Pendaftaran permohonan pasang baru jaringan UPAB.

GET /api/v1/auth/me Bearer Auth

Mengambil data profil pelanggan & sambungan air aktif.

2. Master Data & Utilitas

GET /api/v1/zones GET /api/v1/categories

Daftar blok zonasi & golongan tarif progresif.

POST /api/v1/tariffs/calculate

Simulasi perhitungan biaya rekening air berdasarkan estimasi m³.

3. Tagihan & Pembayaran Rekening Air

GET /api/v1/bills?status=UNPAID Bearer Auth

Daftar iuran & tagihan rekening air pelanggan.

POST /api/v1/bills/{id}/pay Bearer Auth

Pembayaran online via QRIS / Transfer Bank.

4. Catat Meter Mandiri (Self Reading)

GET /api/v1/meters/current-period Bearer Auth

Mengecek tanggal buka periode catat meter mandiri bulan ini.

POST /api/v1/meters/record Multipart Form

Kirim angka stand meter + foto bukti meteran fisik dari HP.

5. Pengaduan Gangguan TRC (Helpdesk)

GET /api/v1/complaints POST /api/v1/complaints

Laporan pipa bocor / air keruh & tracking tindak lanjut TRC.

Standar Komponen UI & Form Playground

Pengujian langsung interaktivitas form, datatable, searchable select, flatpickr, dan filepond.

Komponen Dasar

Form Input, Textarea & Button States

Pondasi input form untuk data sambungan, angka meteran, validasi error, clearable button, dan character count.

Nomor Sambungan Pelanggan (ID Pelanggan)

Format standar 13 digit nomor kontrak sambungan.

Nomor Seri Meteran Air (Error State Demo)

Nomor seri meteran ini telah terdaftar pada pelanggan lain.

Stand Meter Awal (m³)

Angka meteran periode sebelumnya.

Stand Meter Akhir (m³)

Angka meteran fisik terbaru di lapangan.

Catatan Kondisi Fisik & Pemeriksaan Meteran

Maksimal 500 karakter dengan indikator penghitung dinamis.

Dokumentasi Galeri Teknis WTP & Jaringan Pipa

Arsip foto fasilitas pengolahan air bersih, reservoir, pompa distribusi, dan jaringan pipa komplek.

WTP & Pabrik Air

Instalasi Pengolahan Air (WTP & Clarifier)

Unit sedimentasi, koagulasi, dan filtrasi air baku berkapasitas 500 liter/detik dengan standar baku mutu.

Aug 2025

Infrastruktur Pipa

Stasiun Pompa Intake & Pipa Distribusi

Stasiun pompa penyedot air baku dan jaringan valve manifold untuk distribusi ke komplek & kawasan industri.

Sep 2025

Laboratorium & Mutu

Laboratorium Uji Kualitas TDS & Mikrobiologi

Pengujian harian parameter fisik, kimiawi, TDS, pH, dan mikrobiologis sesuai standar Permenkes RI.

Oct 2025

SCADA & Otomasi

Pusat Kontrol SCADA & Telemetri Debit Air

Pemantauan tekanan pipa transmisi, sensor debit air, dan deteksi anomali kebocoran pipa (NRW) real-time.

Nov 2025

Infrastruktur Pipa

Reservoir Gravitasi Penampung Air Bersih

Tangki penampung air bersih berkapasitas 5.000 m³ dengan sistem sirkulasi untuk suplai elevasi tinggi.

Dec 2025

WTP & Pabrik Air

Instalasi Pompa Booster & Filtrasi Food Grade

Sistem pompa bertekanan tinggi dengan perpipaan stainless steel sanitari untuk pengolahan air minum pabrik.

Jan 2026

Komponen Baku Notifikasi

Notifikasi Modern SweetAlert2

Standar notifikasi popup toast & dialog konfirmasi interaktif untuk seluruh aksi CRUD dan validasi.

Toast Sukses

Notifikasi pojok kanan atas setelah simpan/update berhasil.

Toast Error

Peringatan kegagalan proses atau kesalahan sistem.

Toast Peringatan

Pemberitahuan anomali atau data di luar batas normal.

Modal Dialog

Popup modal dialog informatif di tengah layar.

Dokumentasi Sistem & REST API Postman