Register New User
POST/auth/register
Endpoint para criar novas contas de usuário com uma empresa associada. Fluxo Típico:
- O cliente envia dados de usuário e empresa
- O servidor valida que o e-mail e o NIF/CIF (número de identificação fiscal) são únicos
- Cria tanto o usuário quanto a empresa em uma única operação
- Atribui automaticamente o usuário como administrador da nova empresa
- Retorna um token JWT e as informações do usuário criado Casos de Uso:
- Registro de novas empresas na plataforma
- Integração automática de usuários e empresas
- Criação de contas de teste ou demonstração Validações Aplicadas:
- O e-mail deve ser único no sistema
- O NIF/CIF da empresa deve ser único
- Comprimento mínimo de senha de 6 caracteres
- O e-mail deve ter um formato válido
- O NIF/CIF deve ter entre 6 e 15 caracteres Notas Importantes:
- Tanto o usuário quanto a empresa são criados em uma transação atômica
- O usuário é automaticamente designado como administrador da empresa
- Um e-mail de verificação é enviado automaticamente
- A empresa começa com o plano "default"
- O tipo de conta pode ser atualizado posteriormente Dados Criados Automaticamente:
- ID exclusivo para usuário e empresa
- Carimbos de data/hora de criação (createdAt, updatedAt)
- Status ativo por padrão
- Token de verificação de e-mail
Request
Responses
- 201
- 400
Usuário e empresa criados com sucesso
Erro de validação - E-mail ou NIF/CIF duplicado