Criar Novo Usuário

Descrição

Cria um novo usuário no sistema, associando-o automaticamente a uma role padrão (ex.: "Individual").

Verbo

POST

URL Base

https://api.soargi.com

Endpoint

/users/create

Cabeçalhos

Parâmetro Valor
Content-Type application/json
Authorization Bearer Token

Campos Esperados

Campo Tipo Obrigatório Descrição
first_name string Sim Primeiro nome do usuário.
last_name string Sim Último nome do usuário.
email string Sim E-mail do usuário. Deve ser único e válido.
password string Sim Senha do usuário. Deve ser criptografada antes de salvar.
role_id integer Não ID da role do usuário. Padrão: 3 (Individual).

Corpo da Requisição

{
  "first_name": "John",
  "last_name": "Doe",
  "email": "johndoe@example.com",
  "password": "senha1234",
  "role_id": 3
}

Observação: O corpo da requisição deve ser enviado como JSON no formato raw.

Respostas

Sucesso - 201

{
  "status": "success",
  "message": "User created successfully.",
  "user": {
    "user_id": 1,
    "first_name": "John",
    "last_name": "Doe",
    "email": "johndoe@example.com",
    "created_at": "2025-04-23T12:00:00Z"
  }
}

Erro - 400 (Dados inválidos)

{
  "status": 400,
  "error": 400,
  "messages": {
    "error": "Validation errors occurred."
  }
}

Erro - 500 (Erro no servidor)

{
  "status": 500,
  "error": "Error creating user and assigning role."
}

Códigos de Resposta

  • 201 - Usuário criado com sucesso
  • 400 - Dados inválidos ou campos ausentes
  • 500 - Erro ao salvar usuário no banco