Zum Hauptinhalt springen

Get my active auctions

GET 
/company/bid-auctions/mine

Gibt eine paginierte Liste aller Auktionen zurück, bei denen der authentifizierte Benutzer Gebote abgegeben hat. Enthält Auktionen mit den Status 'published', 'awarded', 'approved' usw.

Ziel​

Ermöglicht es Transportunternehmen, ihre aktiven Gebote zu verwalten, den Status ihrer Teilnahmen zu überprüfen und nach verschiedenen relevanten Kriterien zu filtern.

Anwendungsfälle​

  • Transportunternehmen möchte alle seine aktiven Gebote einsehen
  • Auktionen filtern, die zur Unterzeichnung anstehen
  • Gewonnene oder verlorene Auktionen überprüfen
  • Vollständigen Teilnahmeverlauf einsehen

Filterdiagramm:

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

  B -->|all| C[Alle Gebote des Benutzers]
  B -->|open| D[Veröffentlichte Auktionen<br/>date_end >= heute<br/>status: published]
  B -->|to_sign| E[Zugesprochene, ausstehend<br/>status: awarded<br/>signed_by_trucker: false]
  B -->|awarded| F[Alle zugesprochenen<br/>status: awarded]
  B -->|closed| G[Geschlossene Auktionen<br/>status: locked/canceled/rejected]
  B -->|lost| H[Verlorene<br/>status: approved<br/>Benutzer ist NICHT Gewinner]
  B -->|won| I[Gewonnene<br/>status: approved<br/>Benutzer ist Gewinner]

  C --> J[AuctionsResponse zurückgeben]
  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

Anwendungsbeispiel:

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

**Hervorgehobene Felder in der Antwort

Request​

Responses​

Liste der Auktionen erfolgreich abgerufen. Enthält Paginierungs-Metadaten und ein Array von Auktionen mit den Geboten des Benutzers.

Response Headers