Usuarios-Espacio

Ver en Git

---

API POST /api/escritorio/usuario

Descripción

Endpoint para crear un nuevo usuario en un escritorio/espacio de trabajo. Permite a los administradores del escritorio dar de alta usuarios internos y externos con diferentes configuraciones de cuota y permisos.

URL

POST /api/escritorio/usuario

Autenticación

• Requerida: Sí
• Tipo: Token JWT
• Permisos: El usuario debe ser administrador interno del escritorio

Parámetros del Request

Content-Type

• application/x-www-form-urlencoded

Parámetros (form-data)

Parámetro	Tipo	Requerido	Descripción
nombre	string	Sí	Nombre del usuario
apellido	string	No	Apellido del usuario
email	string	Sí	Email del usuario (debe ser válido)
cuota	string/number	No	Cuota de hectáreas asignada al usuario. Vacío = ilimitada
id_tipo_usuario	string/number	No	ID del tipo de usuario en el escritorio

Validaciones

Validaciones de Permisos

• El usuario que hace la petición debe ser administrador interno del escritorio
• Solo usuarios internos pueden ser administradores del escritorio

Validaciones de Cuota

• Si se especifica cuota garantizada, debe haber espacio disponible en el escritorio
• La cuota disponible se calcula considerando: cuota total del escritorio - cuotas garantizadas - consumo actual

Validaciones de Usuario

• El email debe ser válido
• El usuario no debe existir previamente en el escritorio
• No se debe superar el límite máximo de usuarios del escritorio

Validaciones de Tipo de Usuario

• El tipo de usuario debe estar disponible para el escritorio
• Debe existir en la base de datos

Respuestas

Éxito (200)

{
  "code": 0,
  "res": "Ok", 
  "info": "Transacción exitosa",
  "user_id": 12345,
  "user_data": {
    "corporate_user": 12345,
    "login": 67890,
    "personal_user": null,
    "account_type": "existing_login",
    "activated_login": true,
    "intern_user": false
  },
  "invitation_token": "abc123..."
}

Errores

Código	Descripción
1	Error general
2	Faltan parámetros obligatorios
3	El usuario debe ser interno para poder administrar el escritorio
4	Solo los administradores del escritorio pueden crear usuarios
5	Ya existe el usuario en el escritorio
6	Superada cuota de miembros
7	Parámetros incorrectos
10	No pudo generarse el usuario
11	Usuario generado, fallo en la invitación
12	Sin cuota disponible para garantizar hectáreas asignadas
13	Este usuario debe ser dado de alta por un administrador del espacio
50	Login existe y la contraseña es inválida