API Μελών Ομάδας

Maintained by: Aether365 Team Audience: Developers Scope: Team member API endpoints - managing user access

Εξουσιοδότηση

Τα endpoints μελών ομάδας χρησιμοποιούν έλεγχο πρόσβασης βάσει ρόλων:

Endpoint	Επιτρεπόμενοι ρόλοι
Λίστα μελών	Owner, Admin, Member
Πρόσκληση μέλους	Owner, Admin
Αλλαγή ρόλου μέλους	Owner
Αφαίρεση μέλους	Owner

---

Λίστα Μελών Ομάδας

Επιστρέφει όλα τα μέλη του πιστοποιημένου λογαριασμού tenant.

GET /tenants/me/members

Παράδειγμα Αιτήματος

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

Παράδειγμα Απάντησης

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

Πεδία Απάντησης

Πεδίο	Τύπος	Περιγραφή
id	string	Αναγνωριστικό μέλους
email	string	Διεύθυνση email μέλους
status	string	active ή pending
role	string	owner, admin ή member
invitedAt	string	Χρονοσφραγίδα ISO 8601 πρόσκλησης
joinedAt	string ή null	Χρονοσφραγίδα ISO 8601 αποδοχής πρόσκλησης

---

Πρόσκληση Μέλους Ομάδας

Αποστέλλει email πρόσκλησης σε νέο μέλος ομάδας.

POST /tenants/me/members/invite

Σώμα Αιτήματος

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

Πεδίο	Τύπος	Υποχρεωτικό	Προεπιλογή	Περιγραφή
email	string	Ναι	-	Διεύθυνση email για πρόσκληση
role	string	Όχι	"member"	"member" ή "admin"

Παράδειγμα Αιτήματος

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

Παράδειγμα Απάντησης

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

Σφάλματα

Κωδικός	HTTP	Περιγραφή
MEMBER_LIMIT_REACHED	429	Ξεπεράστηκε το όριο μελών του πλάνου
MEMBER_ALREADY_EXISTS	409	Αυτό το email είναι ήδη μέλος ή έχει εκκρεμή πρόσκληση
VALIDATION_ERROR	400	Μη έγκυρη διεύθυνση email

---

Αλλαγή Ρόλου Μέλους

Αλλάζει τον ρόλο ενός υπάρχοντος μέλους ομάδας.

PATCH /tenants/me/members/{memberId}

WARNING

Μόνο ο ιδιοκτήτης λογαριασμού (Owner) μπορεί να αλλάξει ρόλους. Οι Admin δεν μπορούν να αλλάξουν ρόλους.

Σώμα Αιτήματος

{
  "role": "admin"
}

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
role	string	Ναι	Νέος ρόλος: "member" ή "admin"

Παράδειγμα Αιτήματος

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

Παράδειγμα Απάντησης

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

---

Αφαίρεση Μέλους Ομάδας

Αφαιρεί ένα μέλος από τον λογαριασμό. Χάνει αμέσως πρόσβαση.

DELETE /tenants/me/members/{memberId}

WARNING

Δεν επιτρέπεται η αφαίρεση του κατόχου λογαριασμού. Για μεταφορά ιδιοκτησίας, επικοινωνήστε με την υποστήριξη.

Παράδειγμα Αιτήματος

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

Παράδειγμα Απάντησης

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