Create a new bid
POST/truckers/auctions/bid
Ermöglicht es einem Transportunternehmen, ein Gebot in einer aktiven Auktion abzugeben.
Anforderungen:
- Authentifizierter und aktiver Benutzer
- Verifiziertes und freigeschaltetes Zahlungskonto
- Auktion im Status 'published'
- Gültiger Gebotsbetrag (größer als 0 und kleiner als das aktuell niedrigste Gebot)
- Transportunternehmer erfüllt die Auktionsanforderungen (Fahrzeugtyp, Kapazität usw.)
Typischer Ablauf:
- Transportunternehmer ruft verfügbare Auktionen ab
- Erhält Details einer bestimmten Auktion
- Gibt ein Gebot mit einem wettbewerbsfähigen Betrag ab
- Wenn das Gebot das niedrigste ist, wird es zum vorläufigen Gewinnergebot
Bei einem Gewinnergebot:
- Transportunternehmer und Versender werden benachrichtigt
- Die Auktion wird für weitere Gebote gesperrt, wenn der Zuschlagspreis erreicht wird
Request
Responses
- 200
- 400
- 401
- 403
- 409
Auktion erfolgreich erstellt
Response Headers
Fehler bei der Anfrage. Mögliche Ursachen:
- Ungültiger Gebotsbetrag
- Auktion nicht gefunden oder ungültig
- Gebot erfüllt nicht die Anforderungen
Response Headers
Unautorisiert
Response Headers
Zugriff verweigert. Mögliche Ursachen:
- Benutzer nicht aktiv
- Zahlungskonto nicht verifiziert
- Keine Berechtigung zum Bieten in dieser Auktion
Response Headers
Konflikt. Mögliche Ursachen:
- Auktion bereits vergeben
- Niedrigeres Gebot existiert bereits
- Zeit-/Standortbeschränkungen