🔑 Documentação de Senha do Cliente

📋 Visão Geral

A seção de Senha agrupa as operações relacionadas à criação, alteração e recuperação de senha do cliente na loja.

Há dois fluxos distintos: a alteração autenticada, em que o cliente já está logado e deseja trocar a senha conhecendo a atual; e a recuperação de senha, destinada ao cliente que perdeu o acesso e precisa redefinir a senha por meio de um código enviado ao e-mail cadastrado.

🔄 Fluxos Disponíveis

Alteração autenticada

O cliente autenticado informa a senha atual, a nova senha e a confirmação via PUT /customer/password. A operação exige token JWT válido e valida que a senha atual confere antes de persistir a alteração.

Recuperação de senha

O fluxo é composto por duas etapas:

POST /customer/password-recovery — solicita o envio de um código de recuperação para o e-mail cadastrado do cliente. PUT /customer/password-recovery — utiliza o código recebido para redefinir a senha sem necessidade de autenticação prévia.

O código de recuperação possui validade limitada. Se expirar antes do uso, é necessário solicitar um novo código repetindo a primeira etapa.

📌 Notas e Considerações

• A alteração autenticada (PUT /customer/password) exige o header Authorization: Bearer {token} — o cliente deve estar logado.
• Os endpoints de recuperação (POST e PUT /customer/password-recovery) são públicos — não exigem autenticação.
• A senha deve ter entre 8 e 64 caracteres. Valores fora desse intervalo são rejeitados.
• O campo confirmPassword deve ser idêntico ao campo password — qualquer divergência retorna erro.

🔑 Atualizar Senha do Cliente

📋 Descrição

Endpoint utilizado para alterar a senha do cliente autenticado.

Para realizar a alteração, o cliente deve informar a senha atual, a nova senha e a confirmação da nova senha. A senha atual é validada antes de qualquer alteração ser persistida.

A senha deve ter entre 8 e 64 caracteres.

🔐 Permissão

• CustomerAuth — autenticação do cliente via token JWT

📝 Parâmetros

🏷️ Headers Obrigatórios

📦 Parâmetros do Corpo

💡 Exemplo de Requisição

1curl --request PUT \
2  --url '{{MAIN_URL}}/customer/password' \
3  --header 'Authorization: Bearer SEU_TOKEN_AQUI' \
4  --header 'Content-Type: application/json' \
5  --data '{
6    "currentPassword": "senhaAtual123",
7    "password": "novaSenha456",
8    "confirmPassword": "novaSenha456"
9  }'

✅ Resposta de Sucesso

HTTP Status: 200 OK

1{
2  "status": true,
3  "data": true
4}

⚠️ Possíveis Erros

> Os cenários abaixo representam os principais erros que podem ocorrer neste endpoint, servindo como referência para entendimento e tratamento das falhas.

📧 Solicitar Recuperação de Senha

📋 Descrição

Endpoint utilizado para solicitar o envio de um código de recuperação de senha ao e-mail cadastrado do cliente.

O código gerado deve ser utilizado no endpoint PUT /customer/password-recovery para concluir a redefinição da senha. O código possui validade limitada — se expirar antes do uso, é necessário acionar este endpoint novamente para gerar um novo.

📝 Parâmetros

🏷️ Headers Obrigatórios

📦 Parâmetros do Corpo

💡 Exemplo de Requisição

1curl --request POST \
2  --url '{{MAIN_URL}}/customer/password-recovery' \
3  --header 'Content-Type: application/json' \
4  --data '{
5    "email": "cliente@exemplo.com"
6  }'

✅ Resposta de Sucesso

HTTP Status: 200 OK

1{
2  "status": true,
3  "data": true
4}

⚠️ Possíveis Erros

> Os cenários abaixo representam os principais erros que podem ocorrer neste endpoint, servindo como referência para entendimento e tratamento das falhas.

🔓 Alterar Senha por Código de Recuperação

📋 Descrição

Endpoint utilizado para redefinir a senha do cliente a partir de um código de recuperação recebido por e-mail.

O código é gerado pelo endpoint POST /customer/password-recovery e enviado para o e-mail cadastrado do cliente. Ele possui validade limitada — se expirar antes do uso, é necessário solicitar um novo código.

A senha deve ter entre 8 e 64 caracteres e o campo confirmPassword deve ser idêntico ao campo password.

📝 Parâmetros

🏷️ Headers Obrigatórios

📦 Parâmetros do Corpo

💡 Exemplo de Requisição

1curl --request PUT \
2  --url '{{MAIN_URL}}/customer/password-recovery' \
3  --header 'Content-Type: application/json' \
4  --data '{
5    "code": "abc123456787654321",
6    "password": "novaSenha456",
7    "confirmPassword": "novaSenha456"
8  }'

✅ Resposta de Sucesso

HTTP Status: 200 OK

1{
2  "status": true,
3  "data": true
4}

⚠️ Possíveis Erros

> Os cenários abaixo representam os principais erros que podem ocorrer neste endpoint, servindo como referência para entendimento e tratamento das falhas.