Skip to main content

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


Corpo da Solicitacao


Exemplo de Solicitacao cURL


Codigo de Solicitacao de Exemplo (Node.js com Axios)


Exemplo de Resposta (Sucesso)


Campos de Resposta


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

1

Fazer login no EazyBe Workspace

O administrador da organizacao deve fazer login no EazyBe Workspace usando suas credenciais.
2

Localizar o Token de Autenticacao

Na pagina da Organizacao, o Token de Autenticacao da Organizacao sera exibido.
3

Copiar e usar o token

O administrador pode copiar o Token de Autenticacao da Organizacao e cola-lo na solicitacao da API.

Codigos de Status de Resposta


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
Isso permite que voce lide com falhas parciais de forma elegante e saiba exatamente quais operacoes foram bem-sucedidas.

Praticas de Higiene

  • Sempre use um Token de Autenticacao de Organizacao valido
  • Nao compartilhe nem exponha seu token publicamente
  • Verifique os enderecos de e-mail antes de fazer chamadas a API para minimizar notFoundEmails
  • Mantenha as credenciais da sua organizacao seguras em todos os momentos
  • Use esta API de forma responsavel - funcionarios removidos perderao acesso aos dados da organizacao
  • Considere implementar uma etapa de confirmacao em sua aplicacao antes de chamar esta API
  • Armazene a resposta da API para fins de auditoria para rastrear quem foi removido e quando

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.