Buscar Dados de Usuário e Evento por E-mail e OTP
Descrição
Permite consultar o user_id e email do usuário (tabela users) a partir do e-mail informado, e o owner_id do evento (tabela events) a partir do código OTP.
Ambos os parâmetros são obrigatórios.
Verbo
POST
URL Base
https://api.soargi.com
Endpoint
/guest/data-user
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 |
---|---|---|---|
string | Sim | E-mail do usuário a ser consultado. | |
otp | string | Sim | Código OTP do evento. |
Corpo da Requisição
{
"email": "email@exemplo.com",
"otp": "123456"
}
Sucesso - 200 (OK)
{
"user_id": 1,
"email": "email@exemplo.com",
"owner_id": 10
}
Erro - 404 (Usuário não encontrado)
{
"status": 404,
"messages": {
"error": "Usuário não encontrado."
}
}
Erro - 404 (Evento não encontrado para o OTP informado)
{
"status": 404,
"messages": {
"error": "Evento não encontrado para o OTP informado."
}
}
Erro - 422 (Campos obrigatórios)
{
"status": 422,
"messages": {
"error": "Os campos email e otp são obrigatórios."
}
}
Erro - 401 (Token ausente ou inválido)
{
"success": false,
"code": 401,
"message": "Token de convidado ausente."
}
Códigos de Resposta
- 200 - Dados retornados com sucesso
- 404 - Usuário ou evento não encontrado
- 422 - Campos obrigatórios ausentes
Observações
- Atenção: Esta rota exige autenticação via token JWT de convidado (enviado no header Authorization).
- Ambos os campos email e otp são obrigatórios.
- O endpoint retorna erro caso algum campo obrigatório não seja informado ou se o e-mail/OTP não existirem.
- O user_id e email são retornados da tabela users.
- O owner_id é retornado da tabela events de acordo com o OTP informado.