Aller au contenu principal

Obtener subastas activas

GET 
/auction/active

Obtiene la lista de subastas activas disponibles para pujar. Las subastas activas son aquellas que:

  • Tienen estado 'published'
  • La fecha actual está entre date_start y date_end
  • No han sido cerradas o canceladas

Parámetros opcionales de query:

  • page: Número de página (default 1)
  • limit: Items por página (default valor de ITEMS_PAGE en .env)
  • search: Texto para buscar en service_code, etl_cargo_method, pallets_type o description
  • status: Filtro por estado (draft, published, closed, cancelled)
  • minDate/maxDate: Rango de fechas para date_start o etl_date

Ejemplo de uso:

GET /api/auction/active?page=1&limit=10&search=urgente

La respuesta incluye paginación y los campos básicos de cada subasta.

Responses​

Lista paginada de subastas activas. Cada item incluye:

  • service_code: Identificador único
  • etl_date/etd_date: Fechas de carga/descarga
  • status: Estado actual
  • cargo_height/cargo_weight: Dimensiones
  • bid_current: Puja actual (si existe)