Passa al contenuto principale

Get my active auctions

GET 
/company/bid-auctions/mine

Restituisce un elenco paginato di tutte le aste in cui l'utente autenticato ha effettuato offerte. Include aste con stato 'published', 'awarded', 'approved', ecc.

Obiettivo​

Consentire ai trasportatori di gestire le loro offerte attive, rivedere lo stato delle loro partecipazioni e filtrare in base a diversi criteri di interesse.

Casi d'Uso​

  • Il trasportatore vuole vedere tutte le sue offerte attive
  • Filtrare aste in attesa di firma
  • Rivedere aste vinte o perse
  • Visualizzare la cronologia completa delle partecipazioni

Diagramma dei Filtri:

flowchart TD
  A[GET /mine?filter=X] --> B{Tipo di filtro}

  B -->|all| C[Tutte le offerte dell'utente]
  B -->|open| D[Aste pubblicate<br/>date_end >= oggi<br/>status: published]
  B -->|to_sign| E[Aste aggiudicate in attesa<br/>status: awarded<br/>signed_by_trucker: false]
  B -->|awarded| F[Tutte le aggiudicate<br/>status: awarded]
  B -->|closed| G[Aste chiuse<br/>status: locked/canceled/rejected]
  B -->|lost| H[Perse<br/>status: approved<br/>utente NON è vincitore]
  B -->|won| I[Vinte<br/>status: approved<br/>utente È vincitore]

  C --> J[Restituire 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

Esempio di utilizzo:

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

Campi salienti nella risposta:

  • my_bid: Importo dell'offerta dell'utente
  • `bid_current

Request​

Responses​

Elenco delle aste ottenuto con successo. Include metadati di impaginazione e un array di aste con le offerte dell'utente.

Response Headers