Logo SOAR

Cadastro de Guest (Convidado)

Descrição

Permite cadastrar um novo usuário do tipo Guest (convidado) informando nome, sobrenome, nome do meio (opcional), e-mail e senha. O usuário será criado com a role "Guest" e poderá ser utilizado para acesso restrito a eventos ou funcionalidades específicas.
A senha (password) deve ter no mínimo 8 caracteres.

Verbo

POST

URL Base

https://api.soargi.com

Endpoint

/guest/register

Cabeçalhos

Parâmetro Valor
Content-Type application/json
Authorization Bearer {token}
Esta rota exige autenticação via token JWT de convidado. O token é obtido ao validar o OTP do evento.

Campos Esperados

Campo Tipo Obrigatório Descrição
first_name string Sim Primeiro nome do usuário.
middle_name string Não Nome do meio do usuário (opcional).
last_name string Sim Sobrenome do usuário.
email string Sim E-mail do usuário.
password string Sim Senha do usuário (mínimo 8 caracteres).

Corpo da Requisição

{
  "first_name": "João",
  "middle_name": "da Silva",
  "last_name": "Souza",
  "email": "joao.souza@example.com",
  "password": "minhasenha123"
}

O campo middle_name é opcional. O campo password é obrigatório e deve ter no mínimo 8 caracteres.

Sucesso - 201 (Criado)

{
  "success": true,
  "user_id": 123,
  "message": "Guest successfully registered."
}

Erro - 409 (E-mail já cadastrado)

{
  "status": 409,
  "messages": {
    "error": "This email is already registered."
  }
}

Erro - 422 (Campos obrigatórios)

{
  "status": 422,
  "messages": {
    "error": "First name, last name, email and password are required."
  }
}

Erro - 401 (Token ausente ou inválido)

{
  "success": false,
  "code": 401,
  "message": "Token de convidado ausente."
}

Códigos de Resposta

  • 201 - Guest cadastrado com sucesso
  • 409 - E-mail já cadastrado
  • 422 - Campos obrigatórios ausentes
  • 500 - Erro interno ao cadastrar guest

Observações

  • Atenção: Esta rota exige autenticação via token JWT de convidado (enviado no header Authorization).
  • Todos os campos são obrigatórios, exceto middle_name.
  • O campo password deve conter no mínimo 8 caracteres.
  • O campo email deve ser único no sistema.
  • O endpoint retorna erro caso algum campo obrigatório não seja informado ou se o e-mail já estiver cadastrado.