Паки

Читайте каталог паков, выдавайте пак напрямую игроку (бесплатно — коины не списываются) и смотрите историю выдач по всем источникам (выдачи через API, погашения клейм-кодов, покупки в магазине, ручные админ-выдачи).

Ссылки на пак

У пака два названия: name — слаг каталога (starter, стабильный, под него пишут скрипты) — и display_name — человекочитаемый заголовок (Starter Pack, его видят игроки).

Где бы пак ни встречался — в самом каталоге, в результате выдачи, в строке леджера, в клейм-коде — это одна и та же форма { id, name, display_name }. Для пака, который всё ещё есть в каталоге, оба названия заполнены. id — главный: используйте его в GET /v1/packs/{id}, чтобы получить полную запись.

Единственное исключение — строка истории выдач, чей пак уже удалён: у неё оба названия равны null. Сама выдача в леджере остаётся, исчезает только запись каталога, на которую она ссылалась.

GET /v1/packs

Список каталога паков.

Скоуп: packs:read.

{
  "data": [
    {
      "id": 5,
      "name": "starter",
      "display_name": "Starter Pack",
      "description": "Помощь новичкам.",
      "category": { "id": 2, "name": "Bundles" },
      "price": 100,
      "enabled": true,
      "shop_enabled": true,
      "buy_limit": { "count": 0, "window_minutes": 0 },
      "image_url": "/api/packs/5/image?raw=1",
      "created_at": "2026-01-01 12:00:00",
      "updated_at": "2026-01-02 09:30:00"
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "total": 1
}

buy_limit.count равный 0 означает «без ограничений». price — стоимость в коинах при покупке через магазин; прямая выдача ниже её игнорирует.

GET /v1/packs/{id}

Один пак по числовому id. 404 not_found, если его нет.

Скоуп: packs:read.

POST /v1/packs/{id}/deliver

Выдать пак напрямую игроку и бесплатно — содержимое выдаётся без списания коинов. Получателя задавайте ровно одним из steam_id или discord_id.

Скоуп: packs:deliver.

POST /v1/packs/5/deliver
Content-Type: application/json

{ "steam_id": "76561198000000000", "quantity": 1 }

{
  "pack": { "id": 5, "name": "starter", "display_name": "Starter Pack" },
  "player": { "steam_id": "76561198000000000", "discord_id": "123456789012345678" },
  "quantity": 1,
  "delivered": true,
  "status": "completed",
  "purchase_id": 42,
  "error_message": null
}

delivered — общий итог; status — точный результат (completed, partial, failed, refund_failed, ledger_failed). Выдача попадает в историю ниже с source: "api".

GET /v1/packs/deliveries

История выдач (журнал покупок паков) — каждый пак, дошедший до игрока, независимо от источника: прямые выдачи через API (api), погашения клейм-кодов (claim), ручные админ-выдачи (admin), покупки в магазине и другое.

Скоуп: packs:read.

{
  "data": [
    {
      "id": 7,
      "pack": { "id": 5, "name": "starter", "display_name": "Starter Pack" },
      "player": { "steam_id": "76561198000000000", "discord_id": "123456789012345678" },
      "quantity": 1,
      "total_price": 0,
      "status": "completed",
      "source": "api",
      "error_message": null,
      "delivered_at": "2026-01-03 18:05:00"
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "total": 1
}

player.discord_id — текущая привязка Discord получателя (Discord едет рядом со Steam — null, когда не привязан), независимо от того, что было записано в момент выдачи.

Ошибки

Стандартный конверт ошибки.