Circles API

GET /v1/me/circles

Список кіл поточного користувача.

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

Відповідь 200

{
  "data": [
    {
      "id": "circle-uuid",
      "name": "Найближчі",
      "memberCount": 8,
      "members": [
        {
          "id": "user-uuid",
          "name": "Марія Коваль",
          "avatar": "https://cdn.pisd.uk/avatars/uuid.jpg"
        }
      ]
    }
  ]
}

TIP

members містить до 6 учасників для превью. Повний список — через GET /v1/me/circles/:id.

---

GET /v1/me/circles/:id

Повний список учасників кола.

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

Відповідь 200

{
  "id": "circle-uuid",
  "name": "Найближчі",
  "memberCount": 8,
  "members": [
    {
      "id": "user-uuid",
      "name": "Марія Коваль",
      "username": "maria_koval",
      "avatar": "https://cdn.pisd.uk/avatars/uuid.jpg"
    }
  ],
  "createdAt": "2024-01-01T00:00:00Z"
}

---

POST /v1/me/circles

Створити нове коло.

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

Тіло запиту

{
  "name": "Велогрупа"
}

Поле	Тип	Обов'язкове	Опис
name	string	✅	Назва кола (2–50 символів)

Відповідь 201

{
  "id": "circle-uuid",
  "name": "Велогрупа",
  "memberCount": 0,
  "members": []
}

---

DELETE /v1/me/circles/:id

Видалити коло.

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

Відповідь 200

{ "success": true }

---

POST /v1/me/circles/:id/members

Додати учасника до кола.

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

Тіло запиту

{
  "userId": "user-uuid"
}

Відповідь 201

{
  "circleId": "circle-uuid",
  "user": {
    "id": "user-uuid",
    "name": "Марія Коваль",
    "avatar": "https://cdn.pisd.uk/avatars/uuid.jpg"
  }
}

Помилки

Код	Причина
404	Коло або користувач не знайдені
409	Користувач вже у колі

---

DELETE /v1/me/circles/:id/members/:memberId

Видалити учасника з кола.

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

Відповідь 200

{ "success": true }