# DAMRI Sandbox

> Situs dan API tiruan Perum DAMRI di atas data sintetis. Prototipe DACA untuk pengembangan asisten percakapan. Seluruh angka adalah karangan yang dibuat masuk akal; tidak tersambung ke sistem produksi DAMRI.

## Pengetahuan

### bagasi
- [Bagasi Hilang atau Rusak](https://localhost:3020/api/v1/knowledge/bagasi-kehilangan-kerusakan): dokumen bagasi; halaman manusia /kebijakan-refund
- [Ketentuan Bagasi Penumpang](https://localhost:3020/api/v1/knowledge/bagasi-ketentuan-umum): dokumen bagasi; halaman manusia /syarat-ketentuan

### layanan
- [Angkutan Antar Kota Antar Provinsi (AKAP)](https://localhost:3020/api/v1/knowledge/layanan-angkutan-antarkota): dokumen layanan; halaman manusia /layanan/antar-kota
- [Angkutan Antar Kota Dalam Provinsi (AKDP)](https://localhost:3020/api/v1/knowledge/layanan-angkutan-dalam-provinsi): dokumen layanan; halaman manusia /layanan/antar-kota
- [Angkutan Bandara](https://localhost:3020/api/v1/knowledge/layanan-angkutan-bandara): dokumen layanan; halaman manusia /layanan/bandara
- [Angkutan Kota (Perkotaan)](https://localhost:3020/api/v1/knowledge/layanan-angkutan-kota): dokumen layanan; halaman manusia /layanan/angkutan-kota
- [Angkutan Lintas Batas Negara](https://localhost:3020/api/v1/knowledge/layanan-lintas-batas): dokumen layanan; halaman manusia /layanan/lintas-batas
- [Angkutan Logistik dan Kargo](https://localhost:3020/api/v1/knowledge/layanan-logistik): dokumen layanan; halaman manusia /logistik
- [Angkutan Pariwisata (Sewa Bus)](https://localhost:3020/api/v1/knowledge/layanan-pariwisata): dokumen layanan; halaman manusia /sewa-bus
- [Angkutan Perintis](https://localhost:3020/api/v1/knowledge/layanan-perintis): dokumen layanan; halaman manusia /layanan/perintis

### prosedur_agen
- [Pendaftaran Agen dan Mitra Loket](https://localhost:3020/api/v1/knowledge/agen-pendaftaran-mitra): dokumen prosedur_agen; halaman manusia /loket
- [Penjualan dan Pembatalan di Loket Agen](https://localhost:3020/api/v1/knowledge/agen-penjualan-dan-pembatalan): dokumen prosedur_agen; halaman manusia /loket
- [Perhitungan Komisi Agen](https://localhost:3020/api/v1/knowledge/agen-komisi-perhitungan): dokumen prosedur_agen; halaman manusia /loket
- [Prosedur Setoran Harian Agen](https://localhost:3020/api/v1/knowledge/agen-prosedur-setoran-harian): dokumen prosedur_agen; halaman manusia /loket
- [Rekonsiliasi dan Penanganan Selisih](https://localhost:3020/api/v1/knowledge/agen-rekonsiliasi-dan-selisih): dokumen prosedur_agen; halaman manusia /loket

### refund
- [Kebijakan Pembatalan dan Pengembalian Dana (Refund)](https://localhost:3020/api/v1/knowledge/refund-kebijakan-pembatalan): dokumen refund; halaman manusia /kebijakan-refund
- [Pembatalan Perjalanan oleh Operator](https://localhost:3020/api/v1/knowledge/refund-pembatalan-oleh-operator): dokumen refund; halaman manusia /kebijakan-refund
- [Proses dan Lama Pengembalian Dana](https://localhost:3020/api/v1/knowledge/refund-proses-dan-waktu): dokumen refund; halaman manusia /kebijakan-refund

### syarat_ketentuan
- [Barang yang Dilarang Dibawa](https://localhost:3020/api/v1/knowledge/sk-barang-terlarang): dokumen syarat_ketentuan; halaman manusia /syarat-ketentuan
- [Keberangkatan dan Keterlambatan](https://localhost:3020/api/v1/knowledge/sk-keberangkatan-keterlambatan): dokumen syarat_ketentuan; halaman manusia /syarat-ketentuan
- [Ketentuan Penumpang Anak, Lansia, dan Difabel](https://localhost:3020/api/v1/knowledge/sk-anak-dan-lansia): dokumen syarat_ketentuan; halaman manusia /syarat-ketentuan
- [Syarat Pemesanan Tiket](https://localhost:3020/api/v1/knowledge/sk-pemesanan-tiket): dokumen syarat_ketentuan; halaman manusia /syarat-ketentuan

### tarif
- [Batas Atas dan Batas Bawah Tarif AKAP](https://localhost:3020/api/v1/knowledge/tarif-batas-atas-bawah-akap): dokumen tarif; halaman manusia /syarat-ketentuan
- [Kelas Layanan dan Fasilitas](https://localhost:3020/api/v1/knowledge/tarif-kelas-dan-fasilitas): dokumen tarif; halaman manusia /rute

### umum
- [Cara Membeli Tiket](https://localhost:3020/api/v1/knowledge/umum-cara-beli-tiket): dokumen umum; halaman manusia /rute
- [Kontak dan Bantuan Pelanggan](https://localhost:3020/api/v1/knowledge/umum-kontak-bantuan): dokumen umum; halaman manusia /
- [Menemukan Jadwal dan Rute](https://localhost:3020/api/v1/knowledge/umum-jadwal-dan-rute): dokumen umum; halaman manusia /rute
- [Mengecek Status Pesanan](https://localhost:3020/api/v1/knowledge/umum-cek-status-pesanan): dokumen umum; halaman manusia /rute
- [Promo dan Diskon](https://localhost:3020/api/v1/knowledge/umum-promo-dan-diskon): dokumen umum; halaman manusia /promo
- [Tentang Perum DAMRI](https://localhost:3020/api/v1/knowledge/umum-tentang-damri): dokumen umum; halaman manusia /

## API

- [Cari rute](https://localhost:3020/api/v1/routes): GET ?asal=&tujuan=&layanan=&limit=
- [Detail rute](https://localhost:3020/api/v1/routes/:id): GET, termasuk jadwal dan tarif
- [Jadwal](https://localhost:3020/api/v1/schedules): GET ?route_id=&tanggal=
- [Tarif](https://localhost:3020/api/v1/fares): GET ?route_id=&kelas=
- [Ketersediaan kursi](https://localhost:3020/api/v1/availability): GET ?schedule_id=&tanggal=
- [Loket & agen](https://localhost:3020/api/v1/outlets): GET ?kota=&branch_id=
- [Promo](https://localhost:3020/api/v1/promotions): GET ?aktif=true
- [Pencarian pengetahuan (FTS5)](https://localhost:3020/api/v1/knowledge): GET ?q=&kategori=&limit=
- [Cek pesanan](https://localhost:3020/api/v1/bookings/:kode): GET ?telepon4= (wajib 4 digit telepon)
- [Ketersediaan armada](https://localhost:3020/api/v1/fleet/availability): GET ?tanggal_mulai=&tanggal_selesai=&tipe=
- [Estimasi harga charter](https://localhost:3020/api/v1/quotes/estimate): POST, deterministik, rentang bukan angka tunggal
- [Simpan penawaran](https://localhost:3020/api/v1/quotes): POST
- [Simpan lead](https://localhost:3020/api/v1/leads): POST

## Catatan

- Semua respons berbentuk {ok, data, meta:{ts, source}} atau {ok:false, error:{code, message}}.
- Angka untuk pelanggan selalu berasal dari API, tidak pernah dikarang model.
- Harga charter selalu 'estimasi', bukan harga final.