Cuentas y miembros
La función de cuentas y miembros define cómo se organizan las cuentas y cómo se asignan los roles para las operaciones protegidas Inbox Manager. Le brinda control directo sobre quién puede usar cada cuenta y qué cuenta está activa para cada solicitud.
Por qué esto importa
Esta función establece los límites de la cuenta para credenciales, tareas, trabajos, correos electrónicos y registros. Mantiene explícito el cambio de cuentas y la asignación de roles en las membresías, lo que reduce los errores cuando los equipos trabajan entre cuentas principales y secundarias.
Flujo central
Un cliente primero enumera las cuentas accesibles, selecciona la cuenta activa y guarda esa elección mediante el cambio de vista de cuenta. Desde allí, carga datos de cuenta y membresía, luego realiza cambios de cuenta o miembro en esa cuenta.
Operaciones
| Operación | Punto final | Objetivo |
|---|---|---|
| Listar cuentas | GET /api/accounts | Obtener la lista de cuentas accesibles |
| Buscar cuentas | POST /api/accounts/search | Consultar cuenta establecida por filtro |
| Obtener cuenta | GET /api/accounts/:account_id | Recuperar detalles de la cuenta |
| Cambiar cuenta activa | POST /api/account-views/switch | Guardar selección de cuenta activa |
| Crear una cuenta | POST /api/accounts | Crear cuenta raíz o infantil |
| Actualizar cuenta | PATCH /api/accounts/:account_id | Modificar campos de cuenta |
| Eliminar cuenta | DELETE /api/accounts/:account_id | Eliminar cuenta |
| Miembros de la lista | GET /api/accounts/:account_id/members | Obtener membresías de cuentas |
| Agregar miembro | POST /api/accounts/:account_id/members | Crear membresía |
| Actualizar miembro | PATCH /api/accounts/:account_id/members/:member_id | Cambiar metadatos de rol o membresía |
| Eliminar miembro | DELETE /api/accounts/:account_id/members/:member_id | Revocar el acceso a la cuenta |
Datos clave y estado
{
account_id: "acc_...",
parent_account_id: "acc_parent_...", // optional for hierarchy
membership: {
user_id: "uid_...",
role: "owner" | "member" | "viewer"
}
}Modos de falla y controles
Las solicitudes de cuentas fuera del conjunto de membresía de la persona que llama se rechazan y los cambios de miembro requieren el rol correcto. El cambio de cuenta debe apuntar a una cuenta a la que la persona que llama pueda acceder, y los cambios en el ciclo de vida de la cuenta solo ocurren a través de endpoints explícitos de la cuenta.