Komandas dalībnieku API
Autorizācija
| Darbība | Owner | Admin | Member |
|---|---|---|---|
| Dalībnieku saraksts | Jā | Jā | Jā |
| Uzaicināt dalībnieku | Jā | Jā | Nē |
| Mainīt lomu | Jā | Nē | Nē |
| Noņemt dalībnieku | Jā | Nē | Nē |
Komandas dalībnieku saraksts
Atgriež visus autentificētā nomnieka konta dalībniekus.
GET /tenants/me/membersPieprasījuma piemērs
bash
curl https://api.aether365.io/tenants/me/members \
-H "Authorization: Bearer <token>"Atbildes piemērs
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
}
]
}Atbildes lauki
| Lauks | Tips | Apraksts |
|---|---|---|
id | string | Dalībnieka identifikators |
email | string | Dalībnieka e-pasta adrese |
status | string | active vai pending |
role | string | owner, admin vai member |
invitedAt | string | ISO 8601 uzaicinājuma laikspiedols |
joinedAt | string vai null | ISO 8601 laikspiedols, kad uzaicinājums tika pieņemts |
Uzaicināt komandas dalībnieku
Nosūta uzaicinājuma e-pastu jaunam komandas dalībniekam.
POST /tenants/me/members/invitePieprasījuma pamatteksts
json
{
"email": "newmember@example.com",
"role": "member"
}| Lauks | Tips | Obligāts | Apraksts |
|---|---|---|---|
email | string | Jā | Uzaicināmā e-pasta adrese |
role | string | Nē | admin vai member (noklusējums: member) |
Pieprasījuma piemērs
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"}'Atbildes piemērs
json
{
"success": true,
"data": {
"id": "mem_xyz999",
"email": "newmember@example.com",
"status": "pending",
"role": "member",
"invitedAt": "2026-04-12T10:00:00Z",
"joinedAt": null
}
}Kļūdas
| Kods | HTTP | Apraksts |
|---|---|---|
MEMBER_LIMIT_REACHED | 429 | Plāna dalībnieku limits sasniegts |
MEMBER_ALREADY_EXISTS | 409 | Šis e-pasts jau ir dalībnieks vai tam ir gaidošs uzaicinājums |
VALIDATION_ERROR | 400 | Nederīga e-pasta adrese |
Mainīt dalībnieka lomu
Maina komandas dalībnieka lomu. Tikai konta īpašnieks var mainīt lomas.
PATCH /tenants/me/members/{memberId}/rolePieprasījuma pamatteksts
json
{
"role": "admin"
}| Lauks | Tips | Obligāts | Apraksts |
|---|---|---|---|
role | string | Jā | admin vai member |
WARNING
Konta īpašnieka lomu nevar mainīt. Lai nodotu īpašumtiesības, sazinieties ar atbalsta dienestu.
Pieprasījuma piemērs
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"}'Atbildes piemērs
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"
}
}Noņemt komandas dalībnieku
Noņem dalībnieku no konta. Piekļuve tiek nekavējoties atcelta.
DELETE /tenants/me/members/{memberId}WARNING
Konta īpašnieka noņemšana nav atļauta. Lai nodotu īpašumtiesības, sazinieties ar atbalsta dienestu.
Pieprasījuma piemērs
bash
curl -X DELETE https://api.aether365.io/tenants/me/members/mem_def456 \
-H "Authorization: Bearer <token>"Atbildes piemērs
json
{
"success": true,
"data": null
}