Schedule Search - Train API

Endpoint Schedule Search digunakan untuk mencari jadwal keberangkatan dan kepulangan kereta api berdasarkan parameter yang dikirimkan. Endpoint ini akan mengembalikan daftar jadwal yang tersedia dari stasiun asal ke stasiun tujuan beserta informasi tarif dan ketersediaan kursi.

---

🌐 Endpoint POST

https://api.bisabiller.com/api/transport/train/schedule-search

---

🔐 Header

Authorization: Bearer <access_token>
Content-Type: application/json

---

🧾 Body Parameters

{
  "origin": "GMR",
  "destination": "BD",
  "departureDate": "2023-09-10",
  "returnDate": "2023-09-15",
  "adultQuantity": 1,
  "infantQuantity": 0
}

Penjelasan Parameter:

Parameter	Tipe	Deskripsi
origin	string	Kode stasiun asal (mis. GMR untuk Gambir)
destination	string	Kode stasiun tujuan (mis. BD untuk Bandung)
departureDate	string	Tanggal keberangkatan dalam format YYYY-MM-DD
returnDate	string	Tanggal kepulangan (opsional, jika ingin perjalanan PP)
adultQuantity	integer	Jumlah penumpang dewasa
infantQuantity	integer	Jumlah penumpang bayi (jika ada)

---

📤 Contoh Response

{
  "error": false,
  "message": "Jadwal ditemukan",
  "data": {
    "departure": [
      {
        "uniq": "64832b8d61623",
        "org": "GMR",
        "des": "BD",
        "org_time": "2022-07-22 04:55",
        "des_time": "2022-07-22 07:52",
        "dep_date": "2022-07-22",
        "arv_date": "2022-07-22",
        "class": "I",
        "grade": "E",
        "sub_class": "I",
        "name": "ARGO PARAHYANGAN (44A)",
        "number": "5350381",
        "adult_fare": 135000,
        "availability": 330
      }
    ],
    "return": [
      {
        "uniq": "64832b8d67ab9",
        "org": "BD",
        "des": "GMR",
        "org_time": "2022-07-22 04:55",
        "des_time": "2022-07-22 07:52",
        "dep_date": "2022-07-22",
        "arv_date": "2022-07-22",
        "class": "I",
        "grade": "E",
        "sub_class": "I",
        "name": "ARGO PARAHYANGAN (44A)",
        "number": "5350381",
        "adult_fare": 135000,
        "availability": 330
      }
    ]
  }
}

---

Penjelasan Field:

Field	Tipe	Deskripsi
uniq	string	ID unik untuk pemesanan spesifik jadwal tersebut
org	string	Kode stasiun asal
des	string	Kode stasiun tujuan
org_time	string	Waktu keberangkatan
des_time	string	Waktu tiba
dep_date	string	Tanggal keberangkatan
arv_date	string	Tanggal kedatangan
class	string	Kode kelas (mis. I, Q, H, A, dll)
grade	string	Tingkatan kelas (mis. E untuk Eksekutif, K untuk Ekonomi)
sub_class	string	Subkelas kereta (biasanya sama dengan class)
name	string	Nama kereta dan nomor perjalanan
number	string	Nomor kereta
adult_fare	integer	Harga tiket untuk penumpang dewasa
child_fare	integer	Harga tiket untuk anak-anak (jika ada)
infant_fare	integer	Harga tiket untuk bayi (jika ada)
availability	integer	Jumlah kursi yang tersedia

---

Catatan:

• Jika returnDate dikirim, maka field return akan berisi jadwal kepulangan.
• Gunakan uniq untuk referensi saat melakukan proses booking.
• Kursi dengan availability = 0 berarti tidak tersedia.
• Data ini dapat berubah sewaktu-waktu, disarankan untuk menampilkan hasil secara real-time ke pengguna.