Komandos narių API

Autorius: Aether365 komanda Auditorija: Kūrėjai Apimtis: Komandos narių API galutiniai taškai - vartotojų prieigos valdymas

Autorizacija

Komandos narių galutiniai taškai naudoja vaidmenimis pagrįstą prieigos kontrolę:

Galutinis taškas	Leidžiami vaidmenys
Narių sąrašas	Owner, Admin, Member
Nario pakvietimas	Owner, Admin
Nario vaidmens keitimas	Owner
Nario pašalinimas	Owner

---

Komandos narių sąrašas

Grąžina visus autentifikuotos organizacijos paskyros narius.

GET /tenants/me/members

Užklausos pavyzdys

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

Atsakymo pavyzdys

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

Atsakymo laukai

Laukas	Tipas	Aprašymas
id	string	Nario identifikatorius
email	string	Nario el. pašto adresas
status	string	active arba pending
role	string	owner, admin arba member
invitedAt	string	ISO 8601 pakvietimo laiko žymė
joinedAt	string arba null	ISO 8601 laiko žymė, kada pakvietimas buvo priimtas

---

Komandos nario pakvietimas

Išsiunčia pakvietimo el. laišką naujam komandos nariui.

POST /tenants/me/members/invite

Užklausos turinys

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

Laukas	Tipas	Būtinas	Numatytasis	Aprašymas
email	string	Taip	-	El. pašto adresas, kuriam kviesti
role	string	Ne	"member"	"member" arba "admin"

Užklausos pavyzdys

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

Atsakymo pavyzdys

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

Klaidos

Kodas	HTTP	Aprašymas
MEMBER_LIMIT_REACHED	429	Pasiektas plano narių limitas
MEMBER_ALREADY_EXISTS	409	Šis el. paštas jau yra narys arba turi laukiantį pakvietimą
VALIDATION_ERROR	400	Neteisingas el. pašto adresas

---

Nario vaidmens keitimas

Pakeičia esamo komandos nario vaidmenį.

PATCH /tenants/me/members/{memberId}

WARNING

Tik paskyros savininkas gali keisti vaidmenis. Administratoriai vaidmenų keisti negali.

Užklausos turinys

{
  "role": "admin"
}

Laukas	Tipas	Būtinas	Aprašymas
role	string	Taip	Naujas vaidmuo: "member" arba "admin"

Užklausos pavyzdys

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

Atsakymo pavyzdys

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

---

Komandos nario pašalinimas

Pašalina narį iš paskyros. Jis iš karto netenka prieigos.

DELETE /tenants/me/members/{memberId}

WARNING

Paskyros savininko pašalinimas negalimas. Norėdami perduoti nuosavybę, susisiekite su palaikymo tarnyba.

Užklausos pavyzdys

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

Atsakymo pavyzdys

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