Método «POST /openapi/v1/users»
Crear un usuario que se añade a un grupo especificado.
Solicitud
Encabezado:
- Authorization: El token de la API de la empresa.
Cuerpo:
- user – un objeto: Un objeto que contiene información personal sobre el usuario.
- fullName – una cadena: El nombre completo del usuario.
- shortName – una cadena: El nombre corto del usuario.
- email – una cadena: La dirección de correo electrónico del usuario.
- group – un objeto: Un objeto con información sobre el grupo al que se asignará al usuario.
- id – una cadena: El identificador del grupo.
|
Ejemplo del cuerpo de una solicitud:
{
user: {
fullName: 'John Doe',
shortName: 'John',
email: 'un@correo.com'
},
group: {
id: '627d5c63f0672a10fbac23bb'
}
}
|
Respuesta
- user – un objeto: Un objeto con información sobre el usuario creado.
- id – una cadena: El identificador del usuario.
|
Ejemplo de una respuesta:
{
user: {
id: '627b4aa62344090b598f7435'
}
}
|
Posibles errores:
- 400 – common-validation: Ha ocurrido un error de validación de la solicitud.
- 401 – common-unauthorized: Ha ocurrido un error de autenticación.
- 402 – no-available-license: No hay suficientes licencias para asignar al usuario a un grupo cuya formación ha comenzado.
- 404 – group-does-not-exists: Esta empresa no tiene un grupo con el identificador indicado.
- 429 – too-many-requests: Había demasiadas solicitudes.
- 409 – user-email-already-exists-in-company: Esta empresa ya tiene un usuario con la dirección de correo electrónico indicada.
Ir arriba