Comptes et membres

Comptes et membres

La fonctionnalité Comptes et membres définit la manière dont les comptes sont organisés et la manière dont les rôles sont attribués pour les opérations protégées du gestionnaire de boîte de réception. Il vous donne un contrôle direct sur qui peut utiliser chaque compte et quel compte est actif pour chaque demande.

Pourquoi c’est important

Cette fonctionnalité définit les limites du compte pour les informations d’identification, les tâches, les tâches, les e-mails et les journaux. Il maintient le changement de compte explicite et l’attribution des rôles dans les adhésions, ce qui réduit les erreurs lorsque les équipes travaillent sur des comptes parents et enfants.

Flux de base

Un client répertorie d’abord les comptes accessibles, sélectionne le compte actif et enregistre ce choix via le changement de vue de compte. À partir de là, il charge les données de compte et d’adhésion, puis effectue des modifications de compte ou de membre sous ce compte.

Opérations

Opération	Point de terminaison	Objectif
Liste des comptes	GET /api/accounts	Récupérer la liste des comptes accessibles
Rechercher des comptes	POST /api/accounts/search	Compte de requête défini par filtre
Obtenir un compte	GET /api/accounts/:account_id	Récupérer les détails du compte
Changer de compte actif	POST /api/account-views/switch	Enregistrer la sélection de compte active
Créer un compte	POST /api/accounts	Créer un compte root ou enfant
Mettre à jour le compte	PATCH /api/accounts/:account_id	Modifier les champs du compte
Supprimer le compte	DELETE /api/accounts/:account_id	Supprimer le compte
Liste des membres	GET /api/accounts/:account_id/members	Récupérer les adhésions au compte
Ajouter un membre	POST /api/accounts/:account_id/members	Créer une adhésion
Mettre à jour le membre	PATCH /api/accounts/:account_id/members/:member_id	Modifier les métadonnées de rôle ou d’adhésion
Supprimer un membre	DELETE /api/accounts/:account_id/members/:member_id	Révoquer l’accès au compte

Données clés et état

{
  account_id: "acc_...",
  parent_account_id: "acc_parent_...", // optional for hierarchy
  membership: {
    user_id: "uid_...",
    role: "owner" | "member" | "viewer"
  }
}

Modes de défaillance et contrôles

Les demandes de comptes en dehors de l’ensemble d’appartenances de l’appelant sont rejetées et les modifications de membre nécessitent le rôle approprié. Le changement de compte doit cibler un compte auquel l’appelant peut accéder, et les modifications du cycle de vie du compte ne se produisent que via des points de terminaison de compte explicites.

Connexes

[Compte] (/fr/types/account), [Adhésion] (/fr/types/membership), [Flux clients du gestionnaire de boîte de réception] (/fr/guides).