Listagem de Comentários

GET /publics/products/comments

Retorna lista paginada de comentários ativos de produtos

Parâmetros de Query

Parâmetros Básicos

Parâmetro	Tipo	Obrigatório	Descrição
limit	integer	Não	Número de itens por página (padrão: 10, máximo: 100)
offset	integer	Não	Deslocamento de registros para paginação (padrão: 0)
fields	array	Não	Array de campos para retornar no response
condition	object	Não	Objeto de condições de filtro
order	array	Não	Array de ordenações

Estrutura do Response

1{
2  "registers": [
3    {
4      "id": 101,
5      "productId": 1234,
6      "parentCommentId": null,
7      "customerId": 567,
8      "customerName": "João Silva",
9      "customerEmail": "joao.silva@email.com",
10      "userId": null,
11      "userName": "",
12      "userEmail": "",
13      "message": "Produto excelente! Superou minhas expectativas. Entrega rápida e embalagem perfeita.",
14      "replyByUser": false,
15      "active": true,
16      "totalReplies": 1,
17      "product": {
18        "id": 1234,
19        "brandId": 1234,
20        "brandName": "TopPhone,
21        "mainCategoryId": 1,
22        "mainCategoryName": "smartphone",
23        "type": "product",
24        "name": "Smartphone XYZ Pro 128GB",
25        "sku": "SMPH001",
26        "url": "/smartphone-xyz-pro-128gb",
27        "comparisonPrice":2199.99,
28        "stock":20,
29        "medias":[
30          {
31            "id": 123,
32            "type": "image",
33            "title": "",
34            "alternativeText": null,
35            "file": "\/upload\/media\/produto-media.webp",
36            "originalFile": "\/upload\/media\/produto-media.png",
37            "size": null,
38            "originalSize": null,
39            "width": null,
40            "height": null,
41            "url": null
42          }
43        ],
44        "combination":[1, 2, 3],
45        "currentAttributes":[
46          {
47            "id":123,
48            "name":"cor",
49            "value":{
50              "id":123,
51              "label":"azul-escuro",
52              "image":null,
53              "originalImage":null,
54              "color":"#00008B",
55              "order":1
56            }
57          }
58        ],
59        "active": true
60      },
61      "createdAt":00",
62      "updatedAt":00"
63    },
64    {
65      "id": 102,
66      "productId": 1234,
67      "parentCommentId": 101,
68      "customerId": null,
69      "customerName": "",
70      "customerEmail": "",
71      "userId": 25,
72      "userName": "Suporte TechStore",
73      "userEmail": "suporte@techstore.com.br",
74      "message": "Olá João! Muito obrigado pelo feedback positivo.",
75      "replyByUser": true,
76      "active": true,
77      "totalReplies": 0,
78      "product": null,
79      "createdAt":00Z",
80      "updatedAt":00Z"
81    }
82  ],
83  "pagination": {
84    "limit": 10,
85    "offset": 0,
86    "pages": 5,
87    "registers": 47
88  }
89}
{
  "registers": [
    {
      "id": 101,
      "productId": 1234,
      "parentCommentId": null,
      "customerId": 567,
      "customerName": "João Silva",
      "customerEmail": "joao.silva@email.com",
      "userId": null,
      "userName": "",
      "userEmail": "",
      "message": "Produto excelente! Superou minhas expectativas. Entrega rápida e embalagem perfeita.",
      "replyByUser": false,
      "active": true,
      "totalReplies": 1,
      "product": {
        "id": 1234,
        "brandId": 1234,
        "brandName": "TopPhone,
        "mainCategoryId": 1,
        "mainCategoryName": "smartphone",
        "type": "product",
        "name": "Smartphone XYZ Pro 128GB",
        "sku": "SMPH001",
        "url": "/smartphone-xyz-pro-128gb",
        "comparisonPrice":2199.99,
        "stock":20,
        "medias":[
          {
            "id": 123,
            "type": "image",
            "title": "",
            "alternativeText": null,
            "file": "\/upload\/media\/produto-media.webp",
            "originalFile": "\/upload\/media\/produto-media.png",
            "size": null,
            "originalSize": null,
            "width": null,
            "height": null,
            "url": null
          }
        ],
        "combination":[1, 2, 3],
        "currentAttributes":[
          {
            "id":123,
            "name":"cor",
            "value":{
              "id":123,
              "label":"azul-escuro",
              "image":null,
              "originalImage":null,
              "color":"#00008B",
              "order":1
            }
          }
        ],
        "active": true
      },
      "createdAt": "2024-04-08 10:30:00",
      "updatedAt": "2024-04-08 10:30:00"
    },
    {
      "id": 102,
      "productId": 1234,
      "parentCommentId": 101,
      "customerId": null,
      "customerName": "",
      "customerEmail": "",
      "userId": 25,
      "userName": "Suporte TechStore",
      "userEmail": "suporte@techstore.com.br",
      "message": "Olá João! Muito obrigado pelo feedback positivo.",
      "replyByUser": true,
      "active": true,
      "totalReplies": 0,
      "product": null,
      "createdAt": "2024-04-08T14:15:00Z",
      "updatedAt": "2024-04-08T14:15:00Z"
    }
  ],
  "pagination": {
    "limit": 10,
    "offset": 0,
    "pages": 5,
    "registers": 47
  }
}

Criar Comentário no Produto

POST /publics/products/{productId}/comments

Cria comentário ou resposta em produto específico

Parâmetros da URL

Parâmetro	Tipo	Obrigatório	Descrição
productId	integer	Sim	ID único do produto

Parâmetros do Body

Campo	Tipo	Obrigatório	Descrição
message	string	Sim	Mensagem do comentário
parentCommentId	integer	Não	ID do comentário pai (para respostas)
customerName	string	Condicional	Nome do cliente (obrigatório se não autenticado, mínimo 3 caracteres)
customerEmail	string	Condicional	Email do cliente (obrigatório se não autenticado, formato válido)

Estrutura do Response

1{
2  "id": 105,
3  "productId": 1234,
4  "parentCommentId": null,
5  "customerId": 567,
6  "customerName": "João Silva",
7  "customerEmail": "joao.silva@email.com",
8  "userId": null,
9  "userName": "",
10  "userEmail": "",
11  "message": "Produto excelente! Superou minhas expectativas. Recomendo!",
12  "replyByUser": false,
13  "active": true,
14  "totalReplies": 0,
15  "product": null,
16  "createdAt":00Z",
17  "updatedAt":00Z"
18}
{
  "id": 105,
  "productId": 1234,
  "parentCommentId": null,
  "customerId": 567,
  "customerName": "João Silva",
  "customerEmail": "joao.silva@email.com",
  "userId": null,
  "userName": "",
  "userEmail": "",
  "message": "Produto excelente! Superou minhas expectativas. Recomendo!",
  "replyByUser": false,
  "active": true,
  "totalReplies": 0,
  "product": null,
  "createdAt": "2024-04-10T15:30:00Z",
  "updatedAt": "2024-04-10T15:30:00Z"
}

Prologue

Getting Started

Architecture Concepts

The Basics

Digging Deeper

Security

Database

Eloquent ORM

Testing

Packages

Listagem de Comentários

Parâmetros de Query

Parâmetros Básicos

Estrutura do Response

Criar Comentário no Produto

Parâmetros da URL

Parâmetros do Body

Estrutura do Response

Nesta página

Products

Packages

Resources