API v1.2 LIVE Sanctum Token Ready

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.

Base URL: https://itbs-alkautsar.cloud/api/v1
API Health Uptime 99.98%
Latency: 42ms PostgreSQL 17 Geo

Skema Tingkat Langganan API Berbayar

Pilih paket kuota kuota request harian sesuai skala kebutuhan organisasi, dinas pemerintah, atau aplikasi Anda.

Penagihan Bulanan Fleksibel
Gratis / Free
Paket Starter

Akses dasar untuk pengembang independen atau eksplorasi awal dataset titik sampah TRINFO.

Rp 0 / bulan
Batas Kuota: 20 Request / hari
Rate Limit: 5 Req / menit
Fitur Termasuk:
  • Akses endpoint publik laporan sampah
  • Akses katalog hadiah & poin reward
  • Format response JSON standar v1
  • Public community support via GitHub
TERPOPULER
Paling Populer
Paket Pro

Solusi ideal untuk startup lingkungan, mitra pengepul swasta, dan komunitas peduli sampah terverifikasi.

Rp 50.000 / bulan
Batas Kuota: 100 Request / hari
Rate Limit: 30 Req / menit
Fitur Termasuk:
  • Kuota 100 Request kuota harian
  • Webhook notifikasi realtime penjemputan
  • Akses data peringatan dini bencana banjir
  • Dukungan filter koordinat radius km
  • Email & Discord technical support
Kapasitas Tinggi
Paket Enterprise

Dioptimalkan untuk integrasi dinas pemerintah, armada DLH kota, dan dashboard analitik tingkat lanjut.

Rp 100.000 / bulan
Batas Kuota: 500 Request / hari
Rate Limit: 100 Req / menit
Fitur Termasuk:
  • 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
Unlimited
Paket Custom Gov

Paket kustomisasi menyeluruh untuk integrasi Smart City tingkat provinsi dan kementerian lingkungan hidup.

Rp 250.000 / bulan
Batas Kuota: Unlimited Request
Rate Limit: Tanpa Batasan
Fitur Termasuk:
  • 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.

Header: Accept: application/json
GET /api/v1/laporan
Publik / Pro / Enterprise

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"
      }
    }
  ]
}
POST /api/v1/laporan
Bearer Token Diperlukan

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,...)"
}
GET /api/v1/peringatan-dini
Publik & Radar Spasial

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"
    }
  ]
}
POST /api/v1/penjemputan/lokasi-truk
Telemetry Realtime

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"
}
GET /api/v1/tanggapan/{laporan_id}
Reward +10 Poin

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"
    }
  ]
}
POST /api/v1/auth/login
Token Generator

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"
  }
}