👤 Usuários

Esta seção da API pública permite criar e excluir usuários dentro de uma plataforma. As operações são autenticadas via token e acessadas por integradores confiáveis, como plataformas de terceiros, automações internas ou integrações com CRMs.

---

📌 Funcionalidades disponíveis

Método	Endpoint	Descrição
POST	/users	Cria um novo usuário
DELETE	/users	Deleta um usuário existente com base no e-mail

---

🔐 Autenticação e Cabeçalhos

Todas as chamadas exigem um token de API no cabeçalho:

HTTP

Authorization: Bearer {SEU_TOKEN_AQUI}
X-Requested-With: XMLHttpRequest
Content-Type: application/json

O token é gerado pelo administrador da plataforma e pode ser regenerado a qualquer momento.

---

📝 Criar usuario(POST /users)

Parâmetros esperados:

Campo	Tipo	Obrigatório	Descrição
full_name	string	✅ Sim	Nome completo do usuário
email	string	✅ Sim	E-mail único dentro da plataforma
phone	string	❌ Opcional	Número com DDD ou DDI
password	string	❌ Opcional	Senha em texto

Notificação por E-mail

Ao criar um usuario com sucesso na plataforma um email de boas vindas será enviado ao usuário:

• Caso o campo password não seja informado, no email terá um link para criar uma senha
• O envio é automático e não exige nenhuma ação adicional na chamada.
• O e-mail só será enviado se o usuário possuir um endereço de e-mail válido.

🧹 Deletar usuário (DELETE /enrollments)

Parâmetros esperados:

Campo	Tipo	Descrição
email	string	E-mail único dentro da plataforma

---

🧠 Observações

• A normalização do telefone é feita automaticamente no padrão brasileiro.
• Caso um email já cadastrado seja utilizado na criação de um novo usuário, será retornado um erro de validação informando que o e-mail já está em uso.
• O campo full_name é dividido em first_name e last_name internamente.
• O campo username é gerado com base no e-mail e garantido como único.
• Caso o campo password não seja fornecido, uma senha aleatória será criada e uma email será enviado para o usuario criar uma senha.
• Ao deletar um usuário, o email continua indisponivel para cadastro.

---