Train Ticket Tracker Backend

A lightweight proxy server for the Shohoz API exclusively designed to fetch and serve train ticket data. This backend does not store or manage data itself; it simply relays requests and responses between clients and the official Shohoz API.

Installation

Follow these steps to run the server locally:

1. Clone the repository (if you haven't already):

   git clone https://github.com/SazidulAlam47/train-ticket-tracker-server.git
   cd train-ticket-tracker-server

2. Install dependencies:

   npm install

3. Configure environment variables:

   • Copy .env.example to .env and fill in your credentials:

    cp .env.example .env

   After copying .env.example to .env, configure the following variables in your .env file:

   # PORT: The port number the server will run on (default: 5000)
   # SHOHOZ_BASE_API: Shohoz API base URL
   # CLIENT_URL: Allowed client URL for CORS

4. Start the server:

   npm start

The server will run on the port specified in your .env file (default: 5000).

Overview

• Purpose: Acts as a middleware between your frontend/client and the Shohoz API, forwarding requests to retrieve train ticket information.
• No local database, user management, or persistent storage.

Features

• Forwards REST API requests to Shohoz API endpoints
• Returns train ticket data from Shohoz

Tech Stack

• Backend: Node.js, Express.js
• Proxy: axios

API Overview

POST /api/v1/tickets

Description:
Fetch available train tickets between two cities for a specific date.
The server sends your request to the Shohoz API and returns the results in a simplified, consistent format.

Request Body

{
    "from": "Dhaka",
    "to": "Khulna",
    "date": "2025-06-09"
}

• from: Departure city (required)
• to: Destination city (required)
• date: Travel date in YYYY-MM-DD format (required)

Example Response

{
    "success": true,
    "message": "Tickets are fetched successfully",
    "data": [
        {
            "trainName": "SUNDARBAN EXPRESS (726)",
            "departureDateTime": "09 Jun, 08:00 am",
            "arrivalDateTime": "09 Jun, 03:40 pm",
            "travelTime": "07h 40m",
            "from": "Dhaka",
            "to": "Khulna",
            "class": "AC_S",
            "fare": 1245,
            "seats": 2,
            "now": "2025-05-31T07:07:31.897Z",
            "link": "https://eticket.railway.gov.bd/booking/train/search?fromcity=Dhaka&tocity=Khulna&doj=09-Jun-2025&class=AC_S"
        },
        {
            "trainName": "CHITRA EXPRESS (764)",
            "departureDateTime": "09 Jun, 07:30 pm",
            "arrivalDateTime": "10 Jun, 04:40 am",
            "travelTime": "09h 10m",
            "from": "Dhaka",
            "to": "Khulna",
            "class": "S_CHAIR",
            "fare": 680,
            "seats": 1,
            "now": "2025-05-31T07:07:31.897Z",
            "link": "https://eticket.railway.gov.bd/booking/train/search?fromcity=Dhaka&tocity=Khulna&doj=09-Jun-2025&class=S_CHAIR"
        }
    ]
}

• success: Indicates request status
• message: Human-readable status message
• data: Array of available tickets with train details, timings, fare, seat count, and direct booking link

How It Works

• Receives POST requests at /api/v1/tickets
• Calls the Shohoz train ticket API with the provided parameters
• Returns ticket data in a consistent, easy-to-use format

Disclaimer

This server only uses the Shohoz public API to fetch and relay train ticket information.