TRINFO REST API Developer Portal
Akses terstandarisasi untuk integrasi data geospasial timbunan sampah, peringatan dini bencana lingkungan, pelacakan armada truk & motor realtime, serta pipeline visi komputer klasifikasi limbah.
Skema Tingkat Langganan API Berbayar
Pilih paket kuota kuota request harian sesuai skala kebutuhan organisasi, dinas pemerintah, atau aplikasi Anda.
Paket Starter
Akses dasar untuk pengembang independen atau eksplorasi awal dataset titik sampah TRINFO.
- Akses endpoint publik laporan sampah
- Akses katalog hadiah & poin reward
- Format response JSON standar v1
- Public community support via GitHub
Paket Pro
Solusi ideal untuk startup lingkungan, mitra pengepul swasta, dan komunitas peduli sampah terverifikasi.
- Kuota 100 Request kuota harian
- Webhook notifikasi realtime penjemputan
- Akses data peringatan dini bencana banjir
- Dukungan filter koordinat radius km
- Email & Discord technical support
Paket Enterprise
Dioptimalkan untuk integrasi dinas pemerintah, armada DLH kota, dan dashboard analitik tingkat lanjut.
- Kuota 500 Request kuota harian
- Akses pipeline AI analisis citra sampah
- Integrasi GPS live tracking armada truk/motor
- API Key Dedicated dengan SLA 99.9%
- Export histori pelacakan GeoJSON & CSV
- Prioritas penanganan bug 24/7
Paket Custom Gov
Paket kustomisasi menyeluruh untuk integrasi Smart City tingkat provinsi dan kementerian lingkungan hidup.
- Akses penuh seluruh 15+ endpoint REST API
- Unlimited request tanpa batas kuota harian
- Dedicated cloud instance & socket gateway
- SLA ketersediaan 99.99%
- Perjanjian NDA & kustomisasi skema DB
Katalog & Spesifikasi Endpoint REST API (v1)
Dokumentasi skema parameter request, response JSON, dan contoh eksekusi curl.
Mengambil seluruh daftar titik lokasi tumpukan sampah untuk visualisasi peta radar dan analitik spasial. Otomatis mengecualikan laporan yang telah selesai/dibersihkan.
Query Parameters:
| Parameter | Tipe | Keterangan |
|---|---|---|
status_id |
Integer (Opsional) | Filter status spesifik (1: Menunggu, 2: Terverifikasi, 5: OTW, 6: Selesai) |
kategori_id |
Integer (Opsional) | Filter kategori (1: Organik, 2: Anorganik, 3: B3, 4: Elektronik) |
Contoh Response (200 OK):
{
"success": true,
"message": "Daftar laporan untuk peta berhasil diambil",
"data": [
{
"id": 4,
"judul": "Tumpukan Limbah Sungai Brantas",
"deskripsi": "Sampah menyumbat aliran air di bawah jembatan",
"latitude": -7.9812,
"longitude": 112.6354,
"alamat_lokasi": "Jl. Basuki Rahmat No. 12, Klojen, Malang",
"perkiraan_berat_kg": 45.0,
"is_resiko_banjir": true,
"tipe_bahaya": "Potensi Banjir",
"foto_url": "http://localhost:8000/storage/laporan/sampah_6ad4e3d5130462.37064354.jpg",
"status": {
"id": 1,
"kode": "menunggu_verifikasi",
"nama": "Menunggu Verifikasi"
}
}
]
}
Mengunggah laporan temuan sampah baru dari warga lengkap dengan foto base64/multipart, koordinat GPS, dan deteksi resiko bencana.
Request Body (multipart/form-data atau JSON):
{
"judul": "Tumpukan Sampah Liar TPS Ilegal",
"deskripsi": "Tumpukan plastik dan sisa ranting menutupi bahu jalan",
"latitude": -7.9826,
"longitude": 112.6308,
"alamat_lokasi": "Jl. Ijen No. 45, Klojen, Kota Malang",
"kategori_sampah_id": 2,
"foto": "(binary file atau data:image/jpeg;base64,...)"
}
Mengambil daftar peringatan dini darurat bencana lingkungan yang sedang aktif (SIAGA / AWAS) dengan radius terdampak dalam meter. Otomatis membersihkan titik yang sampahnya telah diangkut tuntas.
{
"success": true,
"message": "Daftar peringatan dini aktif berhasil diambil",
"data": [
{
"id": 1,
"laporan_id": 4,
"level_peringatan": "AWAS",
"tipe_bahaya": "Potensi Banjir Aliran Sungai",
"radius_terdampak_meter": 500,
"pesan_broadcast": "Waspada luapan air akibat sumbatan sampah pada radius 500m",
"status_aktif": true,
"waktu_broadcast": "2026-10-19T14:30:00Z"
}
]
}
Mengirimkan telemetri posisi GPS armada berjalan (truk bak hidrolik atau sepeda motor DLH) secara berkelanjutan, sinkron dengan peta seluruh pengguna.
{
"laporan_id": 4,
"pengepul_id": 30,
"latitude": -7.9818,
"longitude": 112.6349,
"heading": 87.5,
"kecepatan_kmh": 24.5,
"status_jemput": "otw",
"vehicle_type": "motorcycle" // atau "driving"
}
Mengambil umpan balik dan validasi situasi terkini titik sampah secara kolaboratif oleh komunitas warga.
{
"success": true,
"data": [
{
"id": 12,
"laporan_id": 4,
"komentar": "Tumpukan botol dan kasur masih menyumbat aliran air, tinggi genangan mulai naik",
"tipe_tanggapan": {
"id": 1,
"nama": "Masih Ada"
},
"user": {
"id": 2,
"name": "Budi Santoso",
"role": "warga"
},
"created_at": "2026-10-19T14:45:10Z"
}
]
}
Mendapatkan access token Sanctum untuk mengakses endpoint berproteksi (Simpan, Tanggapan Warga, Dispatch Armada).
{
"email": "admin@trinfo.id",
"password": "password"
}
// Response (200 OK)
{
"success": true,
"token": "3|abcdef123456789...",
"user": {
"id": 1,
"name": "Super Admin",
"email": "admin@trinfo.id",
"role": "admin"
}
}