SDK Gestión de Usuarios
El módulo dypai.users proporciona operaciones a nivel de administrador para gestionar los usuarios de tu proyecto. Estos métodos requieren un token de admin — están pensados para uso en el servidor o paneles de administración, no para código del lado del cliente.
Todas las operaciones de dypai.users requieren un token con permisos de administrador. No expongas tokens de admin en código del lado del cliente.
Estos métodos requieren que el rol del usuario tenga el permiso manage_users activado en system.roles. El rol "admin" lo tiene activado por defecto. Para otros roles, puedes activarlo desde la sección Auth > Roles del dashboard. Consulta el Sistema de Permisos para más detalles.
Listar Usuarios
Recupera una lista paginada de todos los usuarios de tu proyecto.
const { data, error } = await dypai.users.list({
page: 1,
per_page: 20
});
if (data) {
console.log('Usuarios:', data.users);
console.log('Total:', data.total);
}
Crear Usuario
Crea un nuevo usuario programáticamente (omite la confirmación de email).
const { data, error } = await dypai.users.create({
email: 'nuevo@ejemplo.com',
full_name: 'María García'
});
if (error) {
console.error('Error al crear usuario:', error.message);
return;
}
console.log('Usuario creado:', data.id);
Actualizar Usuario
Actualiza los datos de perfil de un usuario existente.
const { data, error } = await dypai.users.update('user-uuid', {
full_name: 'María López'
});
if (error) {
console.error('Error al actualizar usuario:', error.message);
return;
}
console.log('Usuario actualizado:', data.email);
Eliminar Usuario
Elimina permanentemente un usuario de tu proyecto.
const { data, error } = await dypai.users.delete('user-uuid');
if (error) {
console.error('Error al eliminar usuario:', error.message);
return;
}
console.log('Usuario eliminado:', data.success);
Referencia de Métodos
| Método | Descripción |
|---|---|
list({ page, per_page }) | Listar usuarios con paginación. Devuelve { users, total }. |
create({ email, full_name }) | Crear un nuevo usuario. Devuelve el User creado. |
update(userId, { full_name }) | Actualizar el perfil de un usuario. Devuelve el User actualizado. |
delete(userId) | Eliminar un usuario permanentemente. Devuelve { success: boolean }. |