Descripcion General
La API de Eliminacion Masiva de Empleados le permite eliminar varios empleados de su organizacion en una sola solicitud utilizando sus direcciones de correo electronico. Esta API publica esta disenada para que sistemas externos e integraciones gestionen el acceso de empleados sin requerir autenticacion de administrador a traves del flujo JWT estandar. Requiere un Token de Portador de la Organizacion (auth_token) para la autenticacion, asegurando que solo las organizaciones autorizadas puedan eliminar empleados de su espacio de trabajo.
URL de Ruta
Uso de la API
Endpoint:Encabezados
| Encabezado | Descripcion | Ejemplo |
|---|---|---|
Authorization | Token de portador utilizado para la autenticacion. Debe ser un Token de Autenticacion de Organizacion valido. | Bearer YOUR-BEARER-TOKEN |
Content-Type | El tipo de contenido del cuerpo de la solicitud | application/json |
Cuerpo de la Solicitud
| Campo | Tipo | Requerido | Descripcion |
|---|---|---|---|
emails | array de strings | Si | Array de direcciones de correo electronico de empleados a eliminar de la organizacion |
Ejemplo de Solicitud cURL
Codigo de Solicitud de Ejemplo (Node.js con Axios)
Ejemplo de Respuesta (Exitosa)
Campos de Respuesta
| Campo | Tipo | Descripcion |
|---|---|---|
statusCode | number | Codigo de estado HTTP (200 para exito, 400/401/404/500 para errores) |
status | string | Estado de la solicitud ("success" o "error") |
message | string | Mensaje legible que describe el resultado |
data | object | Datos de respuesta que contienen los correos eliminados y no encontrados |
data.removedEmails | array de strings | Lista de direcciones de correo electronico eliminadas exitosamente |
data.notFoundEmails | array de strings | Lista de direcciones de correo electronico no encontradas en el sistema |
Respuestas de Error
401 No Autorizado - Token de Acceso Invalido
400 Solicitud Incorrecta - No Se Proporcionaron Correos
404 No Encontrado - No Se Encontraron Usuarios
500 Error Interno del Servidor
Como Obtener el Token de Autenticacion de la Organizacion
Iniciar sesion en EazyBe Workspace
El administrador de la organizacion debe iniciar sesion en EazyBe Workspace con sus credenciales.
Localizar el Token de Autenticacion
En la pagina de la Organizacion, se mostrara el Token de Autenticacion de la Organizacion.
Codigos de Estado de Respuesta
| Codigo de Estado | Descripcion |
|---|---|
| 200 | Empleados eliminados exitosamente de la organizacion |
| 400 | Solicitud incorrecta - entrada invalida o campos requeridos faltantes |
| 401 | No autorizado - token de acceso invalido o faltante |
| 404 | No encontrado - no se encontraron usuarios para las direcciones de correo proporcionadas |
| 500 | Error interno del servidor - error inesperado del lado del servidor |
Notas Importantes
Que sucede cuando elimina empleados?
- Los empleados son eliminados del espacio de trabajo de la organizacion (
callyzer_user_details) - Su membresia en la organizacion es revocada (
callyzer_user_mappings) - Los usuarios no son eliminados del sistema por completo - solo se elimina su asociacion con esta organizacion especifica
- La API procesara todos los correos validos e informara cuales fueron eliminados exitosamente y cuales no fueron encontrados
Exito Parcial
Si algunos correos no se encuentran en el sistema, la API eliminara los empleados que si fueron encontrados y devolvera ambas listas en la respuesta:- removedEmails: Empleados eliminados exitosamente
- notFoundEmails: Correos que no existen en el sistema
Practicas de Higiene
Casos de Uso
- Automatizacion de Desvinculacion: Elimine automaticamente empleados cuando dejan la empresa
- Gestion Masiva de Usuarios: Elimine varios empleados a la vez durante reestructuraciones organizacionales
- Integracion con Sistemas de RRHH: Sincronice eliminaciones de empleados desde su plataforma de RRHH hacia EazyBe
- Control de Acceso: Revoque rapidamente el acceso de multiples usuarios en situaciones de emergencia
- Integracion con Sistemas Externos: Permita que sistemas de terceros gestionen el acceso de empleados
Si tiene alguna pregunta o necesita mas ayuda, no dude en contactarnos en hey@eazybe.com.