Skip to content

Komandas dalībnieku API

Autorizācija

DarbībaOwnerAdminMember
Dalībnieku saraksts
Uzaicināt dalībnieku
Mainīt lomu
Noņemt dalībnieku

Komandas dalībnieku saraksts

Atgriež visus autentificētā nomnieka konta dalībniekus.

GET /tenants/me/members

Pieprasī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

LauksTipsApraksts
idstringDalībnieka identifikators
emailstringDalībnieka e-pasta adrese
statusstringactive vai pending
rolestringowner, admin vai member
invitedAtstringISO 8601 uzaicinājuma laikspiedols
joinedAtstring vai nullISO 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/invite

Pieprasījuma pamatteksts

json
{
  "email": "newmember@example.com",
  "role": "member"
}
LauksTipsObligātsApraksts
emailstringUzaicināmā e-pasta adrese
rolestringadmin 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

KodsHTTPApraksts
MEMBER_LIMIT_REACHED429Plāna dalībnieku limits sasniegts
MEMBER_ALREADY_EXISTS409Šis e-pasts jau ir dalībnieks vai tam ir gaidošs uzaicinājums
VALIDATION_ERROR400Nederī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}/role

Pieprasījuma pamatteksts

json
{
  "role": "admin"
}
LauksTipsObligātsApraksts
rolestringadmin 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
}
Vai šī lapa bija noderīga?