Referral API

GET /v1/me/invite-stats

Статистика реферальної програми поточного користувача.

Авторизація: Bearer <accessToken>

Відповідь 200

{
  "code": "PSD7XK2",
  "quota": 10,
  "usedCount": 3,
  "peacesBalance": 275,
  "invitees": [
    {
      "id": "user-uuid",
      "name": "Андрій Мельник",
      "avatar": "https://cdn.pisd.uk/avatars/uuid.jpg",
      "joinedAt": "2024-06-15T10:00:00Z"
    }
  ],
  "nextMilestone": {
    "target": 5,
    "quotaBonus": 5
  }
}

Поле	Опис
code	Унікальний 7-символьний реферальний код
quota	Поточний ліміт запрошень
usedCount	Кількість успішно активованих запрошень
peacesBalance	Загальний баланс peaces
invitees	Список запрошених користувачів
nextMilestone.target	Скільки запросити для розширення квоти
nextMilestone.quotaBonus	На скільки збільшиться квота

---

POST /v1/me/use-invite

Активувати реферальний код іншого користувача.

Авторизація: Bearer <accessToken>

Тіло запиту

{
  "code": "PSD7XK2"
}

Поле	Тип	Обов'язкове	Опис
code	string	✅	7-символьний реферальний код

Відповідь 200

{
  "peacesAwarded": 25,
  "inviterName": "Іван Петров"
}

Поле	Опис
peacesAwarded	Кількість peaces нарахованих поточному користувачу (+25)
inviterName	Ім'я запрошувача (для відображення подяки)

Помилки

Код	Причина
400	Неправильний формат коду
404	Код не знайдено або деактивовано
409	Вже використовували код раніше
422	Квота запрошувача вичерпана
403	Власний код не можна використати

Нарахування запрошувачу

При успішній активації запрошувач автоматично отримує +50 peaces, а при досягненні milestone — розширення квоти.

---

GET /v1/config/flags

Поточний стан feature flags.

Авторизація: не потрібна

Відповідь 200

{
  "bringList": true,
  "wishList": true,
  "privateEvents": true,
  "invites": true,
  "templates": true
}

TIP

Застосунок кешує відповідь на 5 хвилин. Зміна флага в адмін-панелі набирає чинності протягом цього часу.