API за членове на екипа

Оторизация

Крайните точки за членове на екипа използват контрол на достъпа, базиран на роли:

Крайна точка	Разрешени роли
Списък на членовете	Owner, Admin, Member
Покана на член	Owner, Admin
Промяна на роля на член	Owner
Премахване на член	Owner

---

Списък с членове на екипа

Връща всички членове на удостоверения акаунт на tenant-а.

GET /tenants/me/members

Примерна заявка

curl https://api.aether365.io/tenants/me/members \
  -H "Authorization: Bearer <token>"

Примерен отговор

{
  "success": true,
  "data": [
    {
      "id": "mem_abc123",
      "email": "alice@example.com",
      "status": "active",
      "role": "owner",
      "invitedAt": "2026-01-15T10:00:00Z",
      "joinedAt": "2026-01-15T10:30:00Z"
    },
    {
      "id": "mem_def456",
      "email": "bob@example.com",
      "status": "active",
      "role": "member",
      "invitedAt": "2026-02-01T09:00:00Z",
      "joinedAt": "2026-02-01T11:00:00Z"
    },
    {
      "id": "mem_ghi789",
      "email": "carol@example.com",
      "status": "pending",
      "role": "member",
      "invitedAt": "2026-04-10T08:00:00Z",
      "joinedAt": null
    }
  ]
}

Полета в отговора

Поле	Тип	Описание
id	string	Идентификатор на члена
email	string	Имейл адрес на члена
status	string	active или pending
role	string	owner, admin или member
invitedAt	string	ISO 8601 времеви печат на поканата
joinedAt	string или null	ISO 8601 времеви печат на приемане на поканата

---

Покана за член на екипа

Изпраща имейл покана на нов член на екипа.

POST /tenants/me/members/invite

Тяло на заявката

{
  "email": "newmember@example.com",
  "role": "member"
}

Поле	Тип	Задължително	По подразбиране	Описание
email	string	Да	-	Имейл адрес за покана
role	string	Не	"member"	"member" или "admin"

Примерна заявка

curl -X POST https://api.aether365.io/tenants/me/members/invite \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"email": "newmember@example.com", "role": "member"}'

Примерен отговор

{
  "success": true,
  "data": {
    "id": "mem_xyz999",
    "email": "newmember@example.com",
    "status": "pending",
    "role": "member",
    "invitedAt": "2026-04-12T10:00:00Z",
    "joinedAt": null
  }
}

Грешки

Код	HTTP	Описание
MEMBER_LIMIT_REACHED	429	Достигнат лимит на членове по план
MEMBER_ALREADY_EXISTS	409	Този имейл вече е член или има изчакваща покана
VALIDATION_ERROR	400	Невалиден имейл адрес

---

Промяна на ролята на член

Променя ролята на съществуващ член на екипа.

PATCH /tenants/me/members/{memberId}

WARNING

Само собственикът на акаунта може да променя ролите. Администраторите нямат право да променят роли.

Тяло на заявката

{
  "role": "admin"
}

Поле	Тип	Задължително	Описание
role	string	Да	Нова роля: "member" или "admin"

Примерна заявка

curl -X PATCH https://api.aether365.io/tenants/me/members/mem_def456 \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"role": "admin"}'

Примерен отговор

{
  "success": true,
  "data": {
    "id": "mem_def456",
    "email": "bob@example.com",
    "status": "active",
    "role": "admin",
    "invitedAt": "2026-02-01T09:00:00Z",
    "joinedAt": "2026-02-01T11:00:00Z"
  }
}

---

Премахване на член от екипа

Премахва член от акаунта. Той незабавно губи достъп.

DELETE /tenants/me/members/{memberId}

WARNING

Премахването на собственика на акаунта не е разрешено. За прехвърляне на собствеността се свържете с поддръжката.

Примерна заявка

curl -X DELETE https://api.aether365.io/tenants/me/members/mem_def456 \
  -H "Authorization: Bearer <token>"

Примерен отговор

{
  "success": true,
  "data": null
}