Auktions-API für Agenten

Ein Agent kann den Stand der Auktion abfragen und für einen Kunden bieten. Das Gebot kommt in die Auktion, sobald der Code aus der E-Mail an den Kunden eingegeben ist.

1. Stand: GET /api/auction/agent/state. Ohne Anmeldung, ohne E-Mails und Namen.

   Anfrage

   GET /api/auction/agent/state?currency=EUR

   Antwort

   {
     "ok": true,
     "currency": "EUR",
     "lots": [{
       "id": 7, "kind": "site_of_the_day",
       "status": "open", "price_usd": 24, "min_next_bid_usd": 25,
       "price": 21, "min_next_bid": 22,
       "ends_at": "2026-09-28T16:00:00.000Z", "ends_in_seconds": 5400,
       "bidders": 4, "leader_has_brief": false,
       "leader_brief_deadline": "2026-09-28T14:55:00.000Z",
       "best_bid_with_brief_usd": 18
     }]
   }

2. Gebot: POST /api/auction/agent/bid mit der E-Mail des Kunden. Der Kunde bekommt einen Code.

   Anfrage

   POST /api/auction/agent/bid
   {"lot": 7, "amount_usd": 25, "email": "client@example.com",
    "name": "Anna", "lang": "en", "accept_rules": true}

   Antwort

   {
     "ok": true, "status": "waiting_for_code",
     "pending_id": "4f1c…", "code_sent_to": "client@example.com",
     "code_expires_at": "2026-09-28T14:40:00.000Z",
     "next": "Ask the client for the 6-digit code…"
   }

3. Code: POST /api/auction/agent/confirm. Die Antwort enthält den Teilnehmerschlüssel.

   Anfrage

   POST /api/auction/agent/confirm
   {"pending_id": "4f1c…", "code": "482913"}

   Antwort

   {
     "ok": true,
     "participant_key": "auk_…",
     "bids": [{"lot": 7, "amount_usd": 25, "entered": true, "leader": true}],
     "brief": {"site_of_the_day": {"ready": false, "missing": […]}}
   }

4. Mit dem Schlüssel: meine Gebote, Stornieren, Briefing und automatisches Bieten.

   Anfrage

   POST /api/auction/agent/brief
   Authorization: Bearer auk_…
   {"answers": {"business": {"name": "…", "description": "…"},
    "price": {"amount": 300, "currency": "EUR"}, "email": "client@example.com"}}

   Antwort

   {
     "ok": true, "saved": ["business", "price", "email"],
     "brief": {"site_of_the_day": {"ready": false,
       "missing": [{"id": "location", "question": "…"}]}}
   }

Das API hat keine Cloudflare-Prüfung: Stattdessen gibt es den E-Mail-Code, Anfragegrenzen und die Prüfung verdächtiger Gebote.

OpenAPI-BeschreibungAuktionsregeln

AuktionBisherige Auktionen