Skip to main content

​
GET /api/v1/user/:id/beans

Vrátí zůstatek a historii transakcí daného uživatele. Pravidla:
  • Self → vidí všechny detaily.
  • Cizí → veřejně viditelný jen zůstatek (záleží na konfiguraci).
Odpověď: 
{
  "data": {
    "balance": 1250,
    "items": [
      { "id": "uuid", "amount": 250, "reason": "achievement.granted", "created_at": "..." },
      { "id": "uuid", "amount": -50, "reason": "admin.correction", "cleared_at": "...", "cleared_by": "..." }
    ]
  }
}

​
POST /api/v1/user/:id/beans

(Admin) Manuálně přičíst nebo odečíst beans. Body: 
{
  "amount": 100,
  "reason": "event.bonus"
}
amount může být záporný.

​
Datový model

Tabulka beans — každá transakce je jeden řádek:
SloupecTyp
idUUID
user_idFK users
amountint (může být záporný)
cleared_atdatetime (nullable)
cleared_byFK users (nullable)
Zůstatek se počítá jako SUM(amount) WHERE cleared_at IS NULL.