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).