API Membri echipă
Autorizare
| Actiune | Owner | Admin | Member |
|---|---|---|---|
| Listare membri | Da | Da | Da |
| Invitare membru | Da | Da | Nu |
| Schimbare rol | Da | Nu | Nu |
| Eliminare membru | Da | Nu | Nu |
Listarea membrilor echipei
Returnează toți membrii contului tenant autentificat.
GET /tenants/me/membersExemplu de cerere
bash
curl https://api.aether365.io/tenants/me/members \
-H "Authorization: Bearer <token>"Exemplu de răspuns
json
{
"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
}
]
}Câmpuri răspuns
| Câmp | Tip | Descriere |
|---|---|---|
id | string | Identificator membru |
email | string | Adresa de email a membrului |
status | string | active sau pending |
role | string | owner, admin sau member |
invitedAt | string | Marcaj temporal ISO 8601 al invitației |
joinedAt | string sau null | Marcaj temporal ISO 8601 când invitația a fost acceptată |
Invitarea unui membru în echipă
Trimite un email de invitație unui nou membru al echipei.
POST /tenants/me/members/inviteCorp cerere
json
{
"email": "newmember@example.com",
"role": "member"
}| Câmp | Tip | Obligatoriu | Descriere |
|---|---|---|---|
email | string | Da | Adresa de email de invitat |
role | string | Nu | admin sau member (implicit: member) |
Exemplu de cerere
bash
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"}'Exemplu de răspuns
json
{
"success": true,
"data": {
"id": "mem_xyz999",
"email": "newmember@example.com",
"status": "pending",
"role": "member",
"invitedAt": "2026-04-12T10:00:00Z",
"joinedAt": null
}
}Erori
| Cod | HTTP | Descriere |
|---|---|---|
MEMBER_LIMIT_REACHED | 429 | Limita de membri a planului atinsă |
MEMBER_ALREADY_EXISTS | 409 | Acest email este deja membru sau are o invitație în așteptare |
VALIDATION_ERROR | 400 | Adresă de email invalidă |
Schimbarea rolului unui membru
Schimba rolul unui membru al echipei. Doar proprietarul contului poate schimba rolurile.
PATCH /tenants/me/members/{memberId}/roleCorp cerere
json
{
"role": "admin"
}| Câmp | Tip | Obligatoriu | Descriere |
|---|---|---|---|
role | string | Da | admin sau member |
WARNING
Rolul proprietarului contului nu poate fi schimbat. Pentru transferul proprietatii, contactati suportul.
Exemplu de cerere
bash
curl -X PATCH https://api.aether365.io/tenants/me/members/mem_def456/role \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"role": "admin"}'Exemplu de raspuns
json
{
"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"
}
}Eliminarea unui membru din echipă
Elimină un membru din cont. Acesta pierde accesul imediat.
DELETE /tenants/me/members/{memberId}WARNING
Eliminarea proprietarului contului nu este permisă. Pentru transferul proprietății, contactați suportul.
Exemplu de cerere
bash
curl -X DELETE https://api.aether365.io/tenants/me/members/mem_def456 \
-H "Authorization: Bearer <token>"Exemplu de răspuns
json
{
"success": true,
"data": null
}