fast24.dev

API аукциона для агентов

Агент может узнать расклад торгов и сделать ставку за клиента. Ставка войдёт в аукцион после кода из письма, которое придёт клиенту.

  1. Расклад: GET /api/auction/agent/state. Без входа, без почт и имён.

    Запрос
    GET /api/auction/agent/state?currency=EUR
    Ответ
    {
  "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. Ставка: POST /api/auction/agent/bid с почтой клиента. Клиенту придёт код.

    Запрос
    POST /api/auction/agent/bid
{"lot": 7, "amount_usd": 25, "email": "client@example.com",
 "name": "Anna", "lang": "en", "accept_rules": true}
    Ответ
    {
  "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. Код: POST /api/auction/agent/confirm. В ответе ключ участника.

    Запрос
    POST /api/auction/agent/confirm
{"pending_id": "4f1c…", "code": "482913"}
    Ответ
    {
  "ok": true,
  "participant_key": "auk_…",
  "bids": [{"lot": 7, "amount_usd": 25, "entered": true, "leader": true}],
  "brief": {"site_of_the_day": {"ready": false, "missing": […]}}
}

  4. С ключом: мои ставки, отмена, бриф и автоставка.

    Запрос
    POST /api/auction/agent/brief
Authorization: Bearer auk_…
{"answers": {"business": {"name": "…", "description": "…"},
 "price": {"amount": 300, "currency": "EUR"}, "email": "client@example.com"}}
    Ответ
    {
  "ok": true, "saved": ["business", "price", "email"],
  "brief": {"site_of_the_day": {"ready": false,
    "missing": [{"id": "location", "question": "…"}]}}
}

Проверки Cloudflare у API нет: её заменяют код из письма, ограничение числа запросов и проверка подозрительных ставок.

Описание OpenAPIПравила аукциона

АукционИстория аукционов