Csapattagok API

Jogosultságkezelés

A csapattag végpontok szerepkör-alapú hozzáférés-vezérlést használnak:

Végpont	Engedélyezett szerepkörök
Tagok listázása	Owner, Admin, Member
Tag meghívása	Owner, Admin
Tag szerepkörének módosítása	Owner
Tag eltávolítása	Owner

---

Csapattagok listázása

Az autentikált bérlőfiók összes tagját adja vissza.

GET /tenants/me/members

Példa kérés

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

Példa válasz

{
  "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
    }
  ]
}

Válasz mezők

Mező	Típus	Leírás
id	string	Tag azonosító
email	string	Tag e-mail címe
status	string	active vagy pending
role	string	owner, admin vagy member
invitedAt	string	Meghívás ISO 8601 időbélyege
joinedAt	string vagy null	Meghívás elfogadásának ISO 8601 időbélyege

---

Csapattag meghívása

Meghívó e-mailt küld egy új csapattagnak.

POST /tenants/me/members/invite

Kéréstörzs

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

Mező	Típus	Kötelező	Alapértelmezett	Leírás
email	string	Igen	-	Meghívandó e-mail cím
role	string	Nem	"member"	"member" vagy "admin"

Példa kérés

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"}'

Példa válasz

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

Hibák

Kód	HTTP	Leírás
MEMBER_LIMIT_REACHED	429	A csomag taglétszám-korlátja elérve
MEMBER_ALREADY_EXISTS	409	Ez az e-mail cím már tag, vagy van függőben lévő meghívója
VALIDATION_ERROR	400	Érvénytelen e-mail cím

---

Csapattag szerepkörének módosítása

Megváltoztatja egy meglévő csapattag szerepkörét.

PATCH /tenants/me/members/{memberId}

WARNING

Csak a fióktulajdonos módosíthat szerepköröket. Az adminisztrátorok nem módosíthatnak szerepköröket.

Kéréstörzs

{
  "role": "admin"
}

Mező	Típus	Kötelező	Leírás
role	string	Igen	Új szerepkör: "member" vagy "admin"

Példa kérés

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

Példa válasz

{
  "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"
  }
}

---

Csapattag eltávolítása

Eltávolít egy tagot a fiókból. A hozzáférése azonnal megszűnik.

DELETE /tenants/me/members/{memberId}

WARNING

A fióktulajdonos nem távolítható el. A tulajdonjog átruházásához forduljon az ügyfélszolgálathoz.

Példa kérés

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

Példa válasz

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