Pular para o conteúdo principal

Register New User

POST 

/auth/register

Endpoint para criar novas contas de usuário com uma empresa associada. Fluxo Típico:

  1. O cliente envia dados de usuário e empresa
  2. O servidor valida que o e-mail e o NIF/CIF (número de identificação fiscal) são únicos
  3. Cria tanto o usuário quanto a empresa em uma única operação
  4. Atribui automaticamente o usuário como administrador da nova empresa
  5. 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

Usuário e empresa criados com sucesso