Booking API

A REST API built with PHP 8.3 and Symfony components for managing booking statistics and maximizing booking profits.

Features

• Calculate booking statistics (average, minimum, and maximum profits per night)
• Find optimal booking combinations to maximize total profit
• CQRS and DDD architectural patterns
• Built with PHP 8.3
• Docker ready
• The application runs on port 8089 to avoid collision with other common ports.

Prerequisites

• Docker and Docker Compose
• Git

Testing the API

You can test the endpoints using either:

• Postman - GUI tool for API testing
• cURL - Command-line tool for HTTP requests

Installation

1. Clone the repository

  git clone https://github.com/dgineblasco/booking-api.git

2. Build and start Docker containers

  docker compose up -d

3. Install dependencies

  docker exec -it booking-api composer install

4. Run phpunit tests

  docker exec -it booking-api vendor/bin/phpunit

API Endpoints

Calculate Booking Statistics

  curl -X POST http://localhost:8089/stats \
  -H "Content-Type: application/json" \
  -d '[
   {
       "request_id": "1",
       "check_in": "2026-01-01",
       "nights": 2,
       "selling_rate": 100,
       "margin": 10.5
   }
  ]'

Response:

{
    "average": 5.25,
    "minimum": 5.25,
    "maximum": 5.25
}

Maximize Bookings

  curl -X POST http://localhost:8089/maximize \
 -H "Content-Type: application/json" \
  -d '[
    {
        "request_id": "A",
        "check_in": "2026-01-01",
        "nights": 5,
        "selling_rate": 1000,
        "margin": 10
    },
    {
        "request_id": "B",
        "check_in": "2026-01-03",
        "nights": 5,
        "selling_rate": 700,
        "margin": 10
    },
    {
        "request_id": "C",
        "check_in": "2026-01-07",
        "nights": 5,
        "selling_rate": 400,
        "margin": 10
    }
  ]'

Response:

{
    "request_ids": ["A", "C"],
    "total_profit": 140,
    "avg_night": 14,
    "min_night": 8,
    "max_night": 20
}