Visao Geral
A API de Remocao em Massa de Funcionarios permite remover varios funcionarios da sua organizacao em uma unica solicitacao usando seus enderecos de e-mail. Esta API publica foi projetada para que sistemas externos e integracoes gerenciem o acesso de funcionarios sem exigir autenticacao de administrador por meio do fluxo JWT padrao. Ela requer um Token de Portador da Organizacao (auth_token) para autenticacao, garantindo que apenas organizacoes autorizadas possam remover funcionarios do seu espaco de trabalho.
URL do Caminho
Uso da API
Endpoint:Cabecalhos
| Cabecalho | Descricao | Exemplo |
|---|---|---|
Authorization | Token de portador usado para autenticacao. Deve ser um Token de Autenticacao de Organizacao valido. | Bearer YOUR-BEARER-TOKEN |
Content-Type | O tipo de conteudo do corpo da solicitacao | application/json |
Corpo da Solicitacao
| Campo | Tipo | Obrigatorio | Descricao |
|---|---|---|---|
emails | array de strings | Sim | Array de enderecos de e-mail dos funcionarios a serem removidos da organizacao |
Exemplo de Solicitacao cURL
Codigo de Solicitacao de Exemplo (Node.js com Axios)
Exemplo de Resposta (Sucesso)
Campos de Resposta
| Campo | Tipo | Descricao |
|---|---|---|
statusCode | number | Codigo de status HTTP (200 para sucesso, 400/401/404/500 para erros) |
status | string | Status da solicitacao ("success" ou "error") |
message | string | Mensagem legivel descrevendo o resultado |
data | object | Dados de resposta contendo e-mails removidos e nao encontrados |
data.removedEmails | array de strings | Lista de enderecos de e-mail removidos com sucesso |
data.notFoundEmails | array de strings | Lista de enderecos de e-mail nao encontrados no sistema |
Respostas de Erro
401 Nao Autorizado - Token de Acesso Invalido
400 Solicitacao Incorreta - Nenhum E-mail Fornecido
404 Nao Encontrado - Nenhum Usuario Encontrado
500 Erro Interno do Servidor
Como Obter o Token de Autenticacao da Organizacao
Fazer login no EazyBe Workspace
O administrador da organizacao deve fazer login no EazyBe Workspace usando suas credenciais.
Localizar o Token de Autenticacao
Na pagina da Organizacao, o Token de Autenticacao da Organizacao sera exibido.
Codigos de Status de Resposta
| Codigo de Status | Descricao |
|---|---|
| 200 | Funcionarios removidos com sucesso da organizacao |
| 400 | Solicitacao incorreta - entrada invalida ou campos obrigatorios ausentes |
| 401 | Nao autorizado - token de acesso invalido ou ausente |
| 404 | Nao encontrado - nenhum usuario encontrado para os enderecos de e-mail fornecidos |
| 500 | Erro interno do servidor - erro inesperado no lado do servidor |
Notas Importantes
O que acontece quando voce remove funcionarios?
- Os funcionarios sao removidos do espaco de trabalho da organizacao (
callyzer_user_details) - A associacao deles a organizacao e revogada (
callyzer_user_mappings) - Os usuarios nao sao excluidos completamente do sistema - apenas a associacao deles com esta organizacao especifica e removida
- A API processara todos os e-mails validos e informara quais foram removidos com sucesso e quais nao foram encontrados
Sucesso Parcial
Se alguns e-mails nao forem encontrados no sistema, a API ainda removera os funcionarios que foram encontrados e retornara ambas as listas na resposta:- removedEmails: Funcionarios removidos com sucesso
- notFoundEmails: E-mails que nao existem no sistema
Praticas de Higiene
Casos de Uso
- Automacao de Desligamento: Remova automaticamente funcionarios quando saem da empresa
- Gerenciamento em Massa de Usuarios: Remova varios funcionarios de uma vez durante reestruturacoes organizacionais
- Integracao com Sistemas de RH: Sincronize remocoes de funcionarios da sua plataforma de RH para o EazyBe
- Controle de Acesso: Revogue rapidamente o acesso de varios usuarios em situacoes de emergencia
- Integracao com Sistemas Externos: Permita que sistemas de terceiros gerenciem o acesso de funcionarios
Se voce tiver alguma duvida ou precisar de mais ajuda, entre em contato conosco em hey@eazybe.com.