💬 Perguntas e Respostas
📋 Visão Geral
O módulo de Perguntas e Respostas permite que o cliente autenticado gerencie os comentários e perguntas que realizou nas páginas de produtos da loja.
Comentários e perguntas podem ser criados diretamente nas páginas de produto — a autenticação é opcional nesse momento, permitindo que clientes convidados também participem das interações. No entanto, o gerenciamento dos próprios comentários, como a exclusão, exige autenticação. Neste contexto, o cliente acessa as funcionalidades pela área de Minha Conta.
Na área restrita, o cliente pode remover comentários que ele mesmo criou, mantendo controle sobre suas interações publicadas nos produtos da loja.
🔄 Entidades Envolvidas
As seguintes entidades participam do fluxo deste módulo:
Cliente
O autor do comentário, identificado pelo token de autenticação. Toda operação de gerenciamento é automaticamente vinculada ao cliente do token.
Comentário de Produto
Registro de uma pergunta ou comentário realizado por um cliente em uma página de produto. Cada comentário está associado a um produto específico e ao cliente que o criou.
📌 Notas e Considerações
- Somente o próprio cliente que criou o comentário pode removê-lo — não é possível remover comentários de outros clientes.
- A exclusão é permanente e irreversível — não há operação de restauração após a remoção.
- O
commentIdinformado na requisição deve pertencer ao cliente autenticado; caso contrário, a operação será rejeitada com erro.
🗑️ Remover Comentário do Produto
/publics/products/comments/{commentId}
Remove comentário de produto criado pelo cliente autenticado
📄 Descrição
Endpoint responsável por remover permanentemente um comentário ou pergunta realizado pelo cliente autenticado em uma página de produto.
Apenas o próprio cliente que criou o comentário tem permissão para removê-lo. A identidade do cliente é determinada pelo token de autenticação enviado na requisição — o commentId informado deve estar associado ao cliente do token para que a operação seja autorizada.
A exclusão é irreversível: não há mecanismo de restauração após a remoção do comentário.
📋 Parâmetros
🔑 Headers Obrigatórios
| Header | Valor | Descrição |
|---|---|---|
Authorization | Bearer {token} | Token de autenticação do cliente |
🔗 Parâmetros de URL
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
commentId | integer | ✅ Sim | ID único do comentário a ser removido |
📝 Exemplo de Requisição
1curl --request DELETE \2 --url '{{MAIN_URL}}/publics/products/comments/123' \3 --header 'Authorization: Bearer SEU_TOKEN_AQUI'✅ Resposta de Sucesso
HTTP Status: 200 OK
1{2 "status": true,3 "data": true4}⚠️ 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.
| Código Interno | HTTP | Descrição |
|---|---|---|
UAPPI_STORE_COMMENT_NOT_FOUND | 400 | ❌ O comentário não foi encontrado ou não pertence ao cliente autenticado. |
EXPIRED_AUTH_TOKEN | 401 | ❌ O token de autenticação do cliente está expirado. |
INVALID_AUTH_TOKEN | 401 | ❌ O token de autenticação do cliente é inválido ou está ausente. |
INVALID_CUSTOMER | 401 | ❌ O cliente associado ao token não está disponível ou foi desativado. |
INVALID_AUTH_HOST | 403 | ❌ O domínio da requisição não corresponde ao domínio registrado no token de autenticação. |