Search available auctions
GET/company/bid-auctions/
Endpoint pour rechercher des enchères de transport disponibles avec des filtres avancés. Permet de filtrer par lieux de chargement/déchargement, type de cargaison et pagination.
Objectif
Faciliter aux transporteurs la recherche d'enchères publiées correspondant à leurs capacités et routes d'intérêt, optimisant le processus de mise en relation entre l'offre et la demande de transport.
Cas d'Utilisation
- Transporteur recherchant des cargaisons disponibles sur une route spécifique (ex : Madrid à Barcelone)
- Transporteur disposant de véhicules réfrigérés recherchant une cargaison à température contrôlée
- Entreprises vérifiant les enchères actives sur le marché
- Intégration avec des systèmes de gestion de flotte pour automatiser la recherche de cargaisons
Exemple d'utilisation :
GET /company/bid-auctions?addr_load=Madrid&addr_delivery=Barcelona&is_fresh=true&page=2
Request
Responses
- 200
- 400
- 401
Enchères trouvées avec succès. Retourne un tableau d'enchères avec les métadonnées de pagination.
Response Headers
Paramètres invalides. Causes possibles :
- Format de page ou limite incorrect
- Valeur booléenne invalide pour is_fresh
Response Headers
Non autorisé. Jeton JWT invalide, expiré ou non fourni.