Skip to content

💬 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 commentId informado na requisição deve pertencer ao cliente autenticado; caso contrário, a operação será rejeitada com erro.

🗑️ Remover Comentário do Produto

DELETE /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

HeaderValorDescrição
AuthorizationBearer {token}Token de autenticação do cliente

🔗 Parâmetros de URL

ParâmetroTipoObrigatórioDescrição
commentIdinteger✅ SimID ú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": 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.

Código InternoHTTPDescrição
UAPPI_STORE_COMMENT_NOT_FOUND400❌ O comentário não foi encontrado ou não pertence ao cliente autenticado.
EXPIRED_AUTH_TOKEN401❌ O token de autenticação do cliente está expirado.
INVALID_AUTH_TOKEN401❌ O token de autenticação do cliente é inválido ou está ausente.
INVALID_CUSTOMER401❌ O cliente associado ao token não está disponível ou foi desativado.
INVALID_AUTH_HOST403❌ O domínio da requisição não corresponde ao domínio registrado no token de autenticação.

Uappi é a melhor opção para o crescimento da sua loja!

;