Search available auctions
GET/company/bid-auctions/
Endpoint per cercare aste di trasporto disponibili con filtri avanzati. Consente di filtrare per ubicazioni di carico/scarico, tipo di carico e paginazione.
Obiettivo
Facilitare ai trasportatori la ricerca di aste pubblicate che corrispondano alle loro capacità e rotte di interesse, ottimizzando il processo di incontro tra domanda e offerta di trasporto.
Casi d'Uso
- Trasportatore che cerca carichi disponibili su una rotta specifica (es: Madrid a Barcellona)
- Trasportatore con veicoli refrigerati che cerca carico a temperatura controllata
- Aziende che verificano aste attive sul mercato
- Integrazione con sistemi di gestione flotte per automatizzare la ricerca di carichi
Esempio di utilizzo:
GET /company/bid-auctions?addr_load=Madrid&addr_delivery=Barcelona&is_fresh=true&page=2
Request
Responses
- 200
- 400
- 401
Aste trovate con successo. Restituisce un array di aste con metadati di impaginazione.
Response Headers
Parametri non validi. Possibili cause:
- Formato della pagina o limite non corretto
- Valore booleano non valido per is_fresh
Response Headers
Non autorizzato. Token JWT non valido, scaduto o non fornito.