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. |
| 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.