API de Vuelos

Descripción

Esta API permite buscar viajes entre dos ciudades en un día específico.

Endpoints

Búsqueda de viajes

GET /journeys/search?date=<YYYY-MM-DD>&from=<IATA>&to=<IATA>

from y to son case insensitive (se aceptan minúsculas y mayúsculas indistintamente). Se valida que from y to sean exactamente 3 caracteres, sin números y que date sea una fecha válida.

API de Pruebas

Para el desarrollo de la API se utiliza se creó un servicio de pruebas (mock) para los datos de vuelos:

https://67a4ced6c0ac39787a1c90b2.mockapi.io/flight-events

Esta URL se puede sobreescribir a través de la variable de entorno API_URL.

Ejemplo de uso con datos de prueba

GET /journeys/search?date=2025-02-09&from=FRA&to=MAD

Ejemplo de respuesta

[
  {
    "connections": 1,
    "path": [
      {
        "flight_number": "AR1234",
        "from": "FRA",
        "to": "MAD",
        "departure_time": "2025-02-09 11:15",
        "arrival_time": "2025-02-09 20:30"
      }
    ]
  },
  {
    "connections": 2,
    "path": [
      {
        "flight_number": "LH9012",
        "from": "FRA",
        "to": "CDG",
        "departure_time": "2025-02-09 12:30",
        "arrival_time": "2025-02-09 14:45"
      },
      {
        "flight_number": "AF3456",
        "from": "CDG",
        "to": "MAD",
        "departure_time": "2025-02-09 17:00",
        "arrival_time": "2025-02-09 20:30"
      }
    ]
  }
]

Ejecución

cp example.env .env
docker compose build
docker compose up

Ejecución de tests

Se requiere tener instalado python3.12 y pip.

python3.12 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
pytest