Aller au contenu principal

Get my active auctions

GET 
/company/bid-auctions/mine

Renvoie une liste paginée de toutes les enchères dans lesquelles l'utilisateur authentifié a soumis des offres. Inclut les enchères avec les statuts 'published', 'awarded', 'approved', etc.

Objectif​

Permettre aux transporteurs de gérer leurs offres actives, de vérifier l'état de leurs participations et de filtrer selon différents critères d'intérêt.

Cas d'Utilisation​

  • Un transporteur souhaite voir toutes ses offres actives
  • Filtrer les enchères en attente de signature
  • Consulter les enchères gagnées ou perdues
  • Voir l'historique complet des participations

Diagramme des Filtres :

flowchart TD
  A[GET /mine?filter=X] --> B{Type de filtre}

  B -->|all| C[Toutes les offres de l'utilisateur]
  B -->|open| D[Enchères publiées<br/>date_end >= aujourd'hui<br/>status: published]
  B -->|to_sign| E[Adjudications en attente<br/>status: awarded<br/>signed_by_trucker: false]
  B -->|awarded| F[Toutes les adjudications<br/>status: awarded]
  B -->|closed| G[Enchères clôturées<br/>status: locked/canceled/rejected]
  B -->|lost| H[Perdues<br/>status: approved<br/>utilisateur N'EST PAS gagnant]
  B -->|won| I[Gagnées<br/>status: approved<br/>utilisateur EST gagnant]

  C --> J[Retourner AuctionsResponse]
  D --> J
  E --> J
  F --> J
  G --> J
  H --> J
  I --> J

  style D fill:#90EE90
  style E fill:#FFD700
  style I fill:#87CEEB
  style H fill:#FFB6C1

Exemple d'utilisation :

GET /company/bid-auctions/mine?filter=to_sign&page=1&limit=10

Champs notables dans la réponse :

  • my_bid

Request​

Responses​

Liste des enchères obtenue avec succès. Inclut les métadonnées de pagination et un tableau d'enchères avec les offres de l'utilisateur.

Response Headers