Angebotsanfrage per API: Österreich und Schweiz

Eine Anfrage im Auftrag des Nutzers vorbereiten

Diese Schnittstelle speichert eine private Angebotsanfrage für Schweiz beim Team von ContainerBook. Gewünschte Angebotswährung: CHF. Sie löst keine Bestellung, Zahlung oder automatische Verteilung an Anbieter aus.

Vor einem POST muss der Nutzer die Angaben prüfen und der Speicherung, Bearbeitung und Kontaktaufnahme per E-Mail ausdrücklich zustimmen. Ein aufgerufenes Unternehmensprofil bleibt Kontext.

Vertrag und Beispiel

Der aktuelle maschinenlesbare Vertrag beschreibt alle Felder und Statuscodes. Beispielwerte ersetzen keine Einwilligung einer Person. Eine Anfrage enthält ausschließlich deren bestätigte Angaben.

POST /api/agents/v1/anfrage
Content-Type: application/json

{
  "country": "ch",
  "category": "seecontainer",
  "mode": "kauf",
  "quantity": "1",
  "postcode": "8001",
  "city": "Zürich",
  "name": "Testperson",
  "email": "[email protected]",
  "message": "Ein 20-Fuss-Container ist gewünscht. Zustand, Lieferung und Entladung sind noch zu klären.",
  "consent": true,
  "cleIdempotence": "8d290e6f-d4c1-4f87-a344-5f5a93cb783a"
}

Referenz und Wiederholung

HTTP 201 bestätigt eine neue Speicherung, HTTP 200 eine bereits gespeicherte identische Anfrage. Beide liefern eine Referenz. Diese Bestätigung ist kein Nachweis für eine Antwort oder eine Übermittlung an Anbieter.

Nach einem Timeout bleibt die Idempotenzkennung für denselben Versuch unverändert. Andere Angaben mit derselben Kennung werden abgelehnt. Bei HTTP 429 die angegebene Wartezeit beachten.