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
- 200
- 400
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)
Error en los parámetros de búsqueda o validación. Ejemplos:
- Formato de fecha inválido
- Valores de paginación incorrectos