Client API

A API REST pode ser usada em seu aplicativo mobile ou para permitir uma maior customização da solução em seu e-commerce ou aplicativo de vendas.

Endpoints

Endpoints de Avaliações de produto

• Obter notas
• Obter avaliações
• Enviar avaliação
• Enviar fotos
• Enviar vídeo
• Enviar atributos de avaliação
• Marcar avaliação como útil
• Marcar avaliação como não útil

Endpoints de Avaliações de loja

• Resumo das avaliações de loja
• Listar avaliações de loja
• Carrossel de avaliações de loja

Endpoints de avaliações de produto

Obter notas

Obtém os dados agregados de avaliações para uma lista de produtos

GET /{customer}/ratings?skus={produtos}

Parâmetros de Query String

Parâmetro	Descrição
skus	IDs de produtos separados por vírgula

Resposta

[
  {
    "product": {
      "image": "https://production-na01-havaianas.demandware.net/on/demandware.static/-/Sites-havaianas-master/default/dw0cc4315e/product-images/4149926_5568_HAVAIANAS-TRACK-PLUS_A.png",
      "name": "Chinelo Havaianas Track Plus",
      "url": "https://production-na01-havaianas.demandware.net/s/Havaianas-BR/p/chinelo%20havaianas%20track%20plus-4149926_5568_390.html"
    },
    "sku": "4149926",
    "aggregateRating": 4.9,
    "recommendedPercentage": 100,
    "reviewCount": 14
  },
  {
    "product": {
      "image": "https://production-na01-havaianas.demandware.net/on/demandware.static/-/Sites-havaianas-master/default/dw45a80267/product-images/4150149_0570_FARM-PAPILLON_A.png",
      "name": "Chinelo Havaianas Farm Papilon",
      "url": "https://production-na01-havaianas.demandware.net/s/Havaianas-BR/p/chinelo%20havaianas%20farm%20papilon-4150149_0570_378.html"
    },
    "sku": "4150149",
    "aggregateRating": 4.8,
    "recommendedPercentage": 96.15384615384616,
    "reviewCount": 26
  }
]

Campos

campo	descrição	tipo de dados
product.image	URL da imagem do produto	string
product.name	nome do produto	string
product.url	URL do produto	string
sku	ID do produto	string
aggregateRating	Nota média do produto	float
recommendedPercentage	Percentual de avaliações que recomendam o produto	float
reviewCount	Total de avaliações do produto	integer

Obter avaliações

Obtém os dados agregados totais e os dados detalhados das primeiras 50 avaliações de um produto

GET /{customer}/{sku}/summary/{sortField,sortOrder}?page={page}&pageSize={pageSize}

Parâmetros de URL

Parâmetro	Descrição
customer	Fornecido pelo nosso time de integração
sku	SKU do produto
sortField	Campos para ordenação (tabela abaixo)
sortOrder	Direção da ordenação (asc ou desc)

Parâmetros de Query String

Parâmetro	Descrição
page	Página a ser obtida
pageSize	Quantidade de avaliações por página

Campos de ordenação

Campo	Descrição
helpfulScore	Score de ordenação (algoritmo padrão - mais úteis)
created	Data da avaliação
rating	Nota da avaliação (1 a 5)

dica

Se os parâmetros page e pageSize não foram enviados, todas as avaliações para o SKU serão retornadas

Resposta

{
  "reviews": [
    {
      "_id": "337892",
      "aggregateRating": 4.6,
      "recommendedPercentage": 100,
      "reviewCount": 13,
      "attributes": [
        {
          "_id": "Qualidade",
          "description": "Qual a sua avaliação sobre a qualidade do material dos produtos da Minimal Club?",
          "avg": 4.854901960784313,
          "type": "stars",
          "choices": []
        },
        {
          "_id": "Atende às necessidades",
          "description": "O produto atende às suas necessidades funcionais?",
          "avg": 1.9280575539568345,
          "type": "multiple-choice",
          "choices": ["Nunca atende", "Às vezes atende", "Sempre atende"]
        },
        {
          "_id": "Tamanho",
          "description": "Você considera o tamanho da Camiseta Minimal maior, menor ou igual quando comparado com outras marcas?",
          "avg": 0.9649805447470817,
          "type": "multiple-choice",
          "choices": ["Menor", "Igual", "Maior"]
        }
      ],
      "reviews": [
        {
          "_id": "612a928939ff8f181675bae8",
          "customer": "tokstok",
          "sku": "337892",
          "name": "Phillip Long",
          "rating": 5,
          "helpful": 4,
          "unhelpful": 0,
          "verified": false,
          "created": "2020-08-30T11:32:11.000Z",
          "status": "published",
          "recommended": true,
          "updated": "2021-12-01T23:08:09.432Z"
        },
        {
          "_id": "612a928939ff8f181675baff",
          "customer": "tokstok",
          "sku": "337892",
          "name": "Walquiria Santos",
          "rating": 5,
          "helpful": 8,
          "unhelpful": 0,
          "verified": false,
          "created": "2019-05-07T11:20:34.000Z",
          "status": "published",
          "recommended": true,
          "updated": "2021-12-12T11:07:54.712Z"
        },
        {
          "_id": "612a928939ff8f181675bb1d",
          "customer": "tokstok",
          "sku": "337892",
          "name": "Elaine Durães",
          "rating": 5,
          "helpful": 5,
          "unhelpful": 0,
          "verified": false,
          "created": "2019-06-30T21:29:58.000Z",
          "status": "published",
          "recommended": true,
          "updated": "2021-12-12T11:07:54.715Z"
        },
        {
          "_id": "612a928939ff8f181675bb29",
          "customer": "tokstok",
          "sku": "337892",
          "name": "Sandra Lopes",
          "rating": 5,
          "helpful": 4,
          "unhelpful": 1,
          "verified": false,
          "created": "2020-08-07T01:46:37.000Z",
          "status": "published",
          "recommended": true,
          "updated": "2021-12-12T11:07:54.713Z"
        },
        {
          "_id": "612a928939ff8f181675bb41",
          "customer": "tokstok",
          "sku": "337892",
          "name": "Vanessa Begalli Martins",
          "rating": 5,
          "helpful": 3,
          "unhelpful": 0,
          "verified": false,
          "created": "2019-10-07T21:51:11.000Z",
          "status": "published",
          "recommended": true,
          "updated": "2021-12-12T11:07:54.712Z"
        },
        {
          "_id": "612a928939ff8f181675bb40",
          "customer": "tokstok",
          "sku": "337892",
          "name": "Jessica Fontes",
          "rating": 4,
          "helpful": 6,
          "unhelpful": 0,
          "verified": false,
          "created": "2020-09-14T21:38:49.000Z",
          "status": "published",
          "recommended": true,
          "updated": "2021-12-12T11:07:54.711Z"
        },
        {
          "_id": "612a928939ff8f181675bb50",
          "customer": "tokstok",
          "sku": "337892",
          "name": "Fabiana Aquim",
          "rating": 4,
          "helpful": 4,
          "unhelpful": 0,
          "verified": false,
          "created": "2021-03-20T22:22:17.000Z",
          "status": "published",
          "recommended": true,
          "updated": "2021-12-12T11:07:54.709Z"
        },
        {
          "_id": "612a928939ff8f181675bb61",
          "customer": "tokstok",
          "sku": "337892",
          "name": "Fernanda Correia",
          "rating": 5,
          "helpful": 4,
          "unhelpful": 0,
          "verified": false,
          "created": "2020-07-12T16:11:20.000Z",
          "status": "published",
          "recommended": true,
          "updated": "2021-12-12T11:07:54.714Z"
        },
        {
          "_id": "612a928939ff8f181675bb62",
          "customer": "tokstok",
          "sku": "337892",
          "name": "Rodrigo JN",
          "rating": 3,
          "helpful": 3,
          "unhelpful": 0,
          "verified": false,
          "created": "2021-06-15T23:34:11.000Z",
          "status": "published",
          "recommended": true,
          "updated": "2021-09-17T17:07:29.170Z"
        },
        {
          "_id": "612a928939ff8f181675bb6f",
          "customer": "tokstok",
          "sku": "337892",
          "name": "Helen Evangelista",
          "rating": 5,
          "helpful": 7,
          "unhelpful": 5,
          "verified": false,
          "created": "2018-08-22T02:37:32.000Z",
          "status": "published",
          "recommended": true,
          "updated": "2021-12-12T11:07:54.708Z"
        },
        {
          "_id": "61452dd5856d062c0f8ee0cf",
          "customer": "tokstok",
          "sku": "337892",
          "name": "Felipe Censi",
          "rating": 5,
          "helpful": 2,
          "unhelpful": 0,
          "verified": false,
          "created": "2021-06-26T12:59:56.000Z",
          "status": "published",
          "recommended": true,
          "updated": "2021-12-12T11:07:54.709Z"
        },
        {
          "_id": "617f3efa63278dc79120e89e",
          "customer": "tokstok",
          "sku": "337892",
          "name": "Elenivalda Teixeira",
          "rating": 4,
          "helpful": 3,
          "unhelpful": 0,
          "verified": false,
          "created": "2021-01-22T13:16:26.000Z",
          "status": "published",
          "recommended": true,
          "updated": "2021-12-01T23:08:09.433Z"
        },
        {
          "_id": "61a862cde3cabb8625858fb9",
          "customer": "tokstok",
          "sku": "337892",
          "name": "Fabiane de Moraes",
          "rating": 5,
          "helpful": 2,
          "unhelpful": 0,
          "verified": false,
          "created": "2021-05-28T17:31:13.000Z",
          "status": "published",
          "recommended": true,
          "updated": "2021-12-12T11:07:54.716Z",
          "pictures": [
            {
              "_id": "629f79d569ede80012ca7172",
              "url": "https://uploads.konfidency.com.br/a98cd120-abe9-436f-b4de-78e8a0b52071"
            }
          ],
          "video": {
            "fileName": null,
            "fileKey": "0cf18fc5-1766-4dc1-9c62-e4a75214b0a6",
            "converted": true,
            "url": "https://uploads.konfidency.com.br/video/0cf18fc5-1766-4dc1-9c62-e4a75214b0a6.mp4"
          }
        }
      ]
    }
  ],
  "composition": [
    {
      "_id": 3,
      "count": 1
    },
    {
      "_id": 4,
      "count": 3
    },
    {
      "_id": 5,
      "count": 9
    }
  ],
  "customerSettings": {
    "minStarsHighlightPDP": 3.5
  },
  "product": {
    "categories": ["Shirts & Tops"],
    "brand": "Minimal Club",
    "name": "Camiseta Minimal",
    "aiSummaryProcessed": "2025-01-08T13:48:32.463Z",
    "aiSummaryText": "As avaliações da Camiseta Minimal destacam sua alta qualidade, conforto excepcional e bom caimento. Os clientes elogiam a durabilidade do material, que se mantém bem após várias lavagens, e o ajuste da camiseta ao corpo. Contudo, não foram citadas reclamações significativas que pudessem afetar a percepção geral do produto.",
    "aiSummaryTopics": {
      "Qualidade": "positive",
      "Conforto": "positive",
      "Tamanho": "positive"
    }
  }
}

Campos

campo	descrição	tipo de dados
_id	SKU do produto	string
aggregateRating	avaliação média do produto	float
recommendedPercentage	percentual de usuários que avaliaram o produto positivamente	double
reviewCount	quantidade total de avaliações	integer
reviews._id	ID único da avaliação	string
reviews.sku	SKU do produto	string
reviews.name	nome do cliente que avaliou	string
reviews.rating	nota atribuída pelo cliente	integer
reviews.text	texto de avaliação do cliente	string
reviews.helpful	quantidade de pessoas que consideraram a avaliação útil	integer
reviews.unhelpful	quantidade de pessoas que não consideraram a avaliação útil	integer
reviews.verified	indica se o cliente é um comprador verificado	boolean
reviews.created	data de envio da avaliação	string (data em formato ISO-8601)
reviews.recommended	indica se o cliente avaliou o produto positivamente	boolean
reviews.update	última data de atualização da avaliação	string (data em formato ISO-8601)
reviews.pictures	fotos enviadas com a avaliação	array
reviews.pictures._id	ID único da foto	string
reviews.pictures.url	URL da foto	string
reviews.video.url	URL do vídeo	string
reviews.attributes._id	Nome do atributo	string
reviews.attributes.description	Descrição detalhada do atributo	string
reviews.attributes.avg	avaliação média do atributo	float
reviews.attributes.type	tipo de atributo	string: stars ou multiple-choice
reviews.attributes.choices	para atributos do tipo multiple-choice, as respostas possíveis	array de strings
product.categories	categorias do produto	array de string
product.brand	marca do produto	string
product.aiSummaryProcessed	data da geração do resumo por IA	string (data em formato ISO-8601)
product.aiSummaryText	texto do resumo gerado por IA	string
product.aiSummaryTopics	tópicos identificados no resumo por IA	par de chave/valor (string/string), podendo o valor ser positive ou negative

dica

Para obter o número de páginas total, sua aplicação deve calcular baseado no campo reviewCount

Enviar avaliação

Permite enviar uma avaliação sobre um produto

POST /{customer}/{sku}/review

Parâmetros de URL

Parâmetro	Descrição
customer	Fornecido pelo nosso time de integração
sku	SKU do produto

Campos do corpo da requisição (JSON)

campo	descrição	tipo de dados
userId	ID do usuário em sua plataforma	string
email	e-mail do usuário em sua plataforma	string
rating	número de estrelas atribuído pelo usuário ao produto	integer
text	texto de avaliação do cliente	string
recommended	indica se o cliente avalia o produto positivamente	boolean

info

Os campos userId e email serão utilizados como chave composta para garantir que o usuário está autenticado corretamente na plataforma e não permitir atribuir avaliações a outros usuários

info

As avaliações precisam ser aprovadas através de nosso dashboard antes de serem publicadas em sua loja.

Exemplo de corpo da requisição

{
  "userId": "12345678-1234-1234-1234-123456789012",
  "email": "[email protected]",
  "rating": 5,
  "text": "Produto perfeito para minhas necessidades"
}

Resposta

{
  "helpful": 0,
  "unhelpful": 0,
  "verified": false,
  "status": "sent",
  "_id": "61b6084bbe562d0018e43cac",
  "created": "2021-12-12T14:33:47.749Z",
  "customer": "tokstok",
  "userId": "12345678-1234-1234-1234-123456789012",
  "name": "Tony S",
  "sku": "337892",
  "text": "Produto perfeito para minhas necessidades",
  "recommended": true,
  "rating": 5,
  "availableAttributes": [
    {
      "categories": ["Produtos"],
      "choices": [],
      "_id": "660ffe859fc8c1323a98d4dc",
      "customer": "tokstok",
      "title": "Qualidade",
      "order": 1,
      "type": "stars",
      "__v": 0
    },
    {
      "categories": null,
      "choices": ["Menor", "Igual", "Maior"],
      "_id": "6781341e6b105a8fe1a9e01b",
      "customer": "tokstok",
      "title": "Tamanho",
      "description": "Você considera o tamanho do produto maior, menor ou igual quando comparado com outras marcas?",
      "order": 1,
      "type": "multiple-choice",
      "__v": 0
    }
  ],
  "updateToken": "26e854ad-a7cb-4170-b790-bdf47ccbfb5e"
}

Campos da resposta

campo	descrição	tipo de dados
_id	ID único da avaliação enviada	string
status	status da avaliação, normalmente será "sent" neste momento	string
created	data do envio da avaliação	string (data em formato ISO-8601)
userId	ID do usuário que realizou a avaliação	string
name	nome do cliente que fez a avaliação	string
sku	SKU do produto	string
rating	número de estrelas atribuído pelo usuário ao produto	integer
text	texto de avaliação do cliente	string
recommended	indica se o cliente avalia o produto positivamente	boolean
verified	indica se o cliente é um comprador verificado do produto	boolean
helpful	quantidade de pessoas que consideraram a avaliação útil	integer
unhelpful	quantidade de pessoas que não consideraram a avaliação útil	integer
availableAttributes._id	ID do atributo	string
availableAttributes.categories	array de categorias onde o atributo é aplicável, ou null se for aplicável a todas	array de string ou null
availableAttributes.type	tipo de atributo: stars ou multiple-choice	string
availableAttributes.order	ordem do atributo (serve para ordenar na interface)	integer
availableAttributes.title	título do atributo	string
availableAttributes.description	texto descritivo para exibir junto ao título do atributo	string
availableAttributes.choices	em caso de atributo do tipo multiple-choice, as opções disponíveis	array de string

Enviar fotos

Permite anexar fotos a uma avaliação enviada recentemente

POST /{customer}/{sku}/review/{reviewId}/pictures

Parâmetros de URL

Parâmetro	Descrição
customer	Fornecido pelo nosso time de integração
sku	SKU do produto
reviewId	ID da avaliação criada

Corpo da requisição

Por conta do upload da foto, esta requisição não utiliza JSON, mas sim o formato multipart/form-data

Será necessário enviar os arquivos e o campo updateToken, cujo valor deve ser o updateToken obtido ao salvar a avaliação.

Enviar vídeo

Permite anexar vídeo a uma avaliação enviada recentemente

POST /{customer}/{sku}/review/{reviewId}/video

Parâmetros de URL

Parâmetro	Descrição
customer	Fornecido pelo nosso time de integração
sku	SKU do produto
reviewId	ID da avaliação criada

Corpo da requisição

Por conta do upload do vídeo, esta requisição não utiliza JSON, mas sim o formato multipart/form-data

Será necessário enviar o arquivo do vídeo e o campo updateToken, cujo valor deve ser o updateToken obtido ao salvar a avaliação.

O vídeo pode ter até 200MB

Enviar atributos de avaliação

Permite enviar os atributos complementares da avaliação, obtidos na propriedade availableAttributes ao enviar a avaliação.

POST /{customer}/{sku}/review/{reviewId}/attributes

Parâmetros de URL

Parâmetro	Descrição
customer	Fornecido pelo nosso time de integração
sku	SKU do produto
reviewId	ID da avaliação criada

Campos da requisição

campo	descrição	tipo de dados
updateToken	updateToken obtido ao salvar a avaliação	string
attributes	array com os atributos preenchidos pelo usuário	array
attributes._id	ID do atributo	string
attributes.value	Valor do atributo (1 a 5 se type=stars, 0-index da resposta se type=multiple-choice)	integer
attributes.response	Valor da resposta se type=multiple-choice	string

Exemplo do corpo da requisição

{
  "updateToken": "26e854ad-a7cb-4170-b790-bdf47ccbfb5e",
  "attributes": [
    {
      "_id": "6781341e6b105a8fe1a9e01b",
      "value": 1,
      "response": "Igual"
    },
    {
      "_id": "660ffe859fc8c1323a98d4dc",
      "value": 5
    }
  ]
}

Marcar avaliação como útil (curtir)

Permite marcar uma avaliação como útil. Este dado é utilizado para que os próprios clientes escolham quais avaliações são mais úteis e ajudem uns aos outros

POST /{customer}/{sku}/review/{reviewId}/like

Parâmetros de URL

Parâmetro	Descrição
customer	Fornecido pelo nosso time de integração
sku	SKU do produto
reviewId	ID único da avaliação

Campos do corpo da requisição (JSON)

campo	descrição	tipo de dados
userId	ID do usuário em sua plataforma	string
email	e-mail do usuário em sua plataforma	string

Exemplo de corpo da requisição

{
  "userId": "12345678-1234-1234-1234-123456789012",
  "email": "[email protected]"
}

Resposta

{
  "helpful": 1,
  "unhelpful": 0,
  "verified": false,
  "status": "published",
  "_id": "61b6084bbe562d0018e43cac",
  "created": "2021-12-12T14:33:47.749Z",
  "customer": "tokstok",
  "userId": "12345678-1234-1234-1234-123456789012",
  "name": "Tony S",
  "sku": "337892",
  "text": "Produto perfeito para minha necessidade",
  "recommended": true,
  "rating": 4,
  "__v": 0
}

Campos da resposta

campo	descrição	tipo de dados
_id	ID único da avaliação enviada	string
status	status da avaliação	string
created	data do envio da avaliação	string (data em formato ISO-8601)
userId	ID do usuário que realizou a avaliação	string
name	nome do cliente que fez a avaliação	string
sku	SKU do produto	string
rating	número de estrelas atribuído pelo usuário ao produto	integer
text	texto de avaliação do cliente	string
recommended	indica se o cliente avalia o produto positivamente	boolean
verified	indica se o cliente é um comprador verificado do produto	boolean
helpful	quantidade de pessoas que consideraram a avaliação útil	integer
unhelpful	quantidade de pessoas que não consideraram a avaliação útil	integer
updateToken	token de atualização para envio de informações complementares	string

Marcar avaliação como não útil (descurtir)

Permite marcar uma avaliação como não útil. Este dado é utilizado para que os próprios clientes escolham quais avaliações são mais úteis e ajudem uns aos outros

POST /{customer}/{sku}/review/{reviewId}/dislike

Parâmetros de URL

Parâmetro	Descrição
customer	Fornecido pelo nosso time de integração
sku	SKU do produto
reviewId	ID único da avaliação

Campos do corpo da requisição (JSON)

campo	descrição	tipo de dados
userId	ID do usuário em sua plataforma	string
email	e-mail do usuário em sua plataforma	string

Exemplo de corpo da requisição

{
  "userId": "12345678-1234-1234-1234-123456789012",
  "email": "[email protected]"
}

Resposta

{
  "helpful": 1,
  "unhelpful": 0,
  "verified": false,
  "status": "published",
  "_id": "61b6084bbe562d0018e43cac",
  "created": "2021-12-12T14:33:47.749Z",
  "customer": "tokstok",
  "userId": "12345678-1234-1234-1234-123456789012",
  "name": "Tony S",
  "sku": "337892",
  "text": "Produto perfeito para minha necessidade",
  "recommended": true,
  "rating": 4,
  "__v": 0
}

Campos da resposta

campo	descrição	tipo de dados
_id	ID único da avaliação enviada	string
status	status da avaliação	string
created	data do envio da avaliação	string (data em formato ISO-8601)
userId	ID do usuário que realizou a avaliação	string
name	nome do cliente que fez a avaliação	string
sku	SKU do produto	string
rating	número de estrelas atribuído pelo usuário ao produto	integer
text	texto de avaliação do cliente	string
recommended	indica se o cliente avalia o produto positivamente	boolean
verified	indica se o cliente é um comprador verificado do produto	boolean
helpful	quantidade de pessoas que consideraram a avaliação útil	integer
unhelpful	quantidade de pessoas que não consideraram a avaliação útil	integer

Endpoints de Avaliações de loja

Resumo das avaliações de loja

Obtém os dados resumidos das avaliações de loja, como quantidade total de avaliações e nota média

GET /{customer}/store-reviews/summary

Parâmetros de URL

Parâmetro	Descrição
customer	Fornecido pelo nosso time de integração

Resposta

[
  {
    "_id": "konfidency",
    "count": 2904,
    "avgRating": 4.747245179063361,
    "enableStoreReview": true
  }
]

Campos

campo	descrição	tipo de dados
_id	ID do cliente	string
count	quantidade de avaliações da loja	integer
avgRating	avaliação média da loja	float
enableStoreReview	indica se as avaliações de loja estão ativas para a loja	boolean

Listar avaliações de loja

Obtém os dados detalhados das avaliações de loja

GET /{customer}/store-reviews/published/{sort}

Parâmetros de URL

Parâmetro	Descrição
customer	Fornecido pelo nosso time de integração
sort	Ordenação dos resultados (ver tabela abaixo)

Ordenação de resultados

A ordenação segue o padrão campo,ordem. A ordem pode ser 1 para crescente ou -1 para decrescente.

Campo	Descrição
created	Data de envio da avaliação
sku	SKU do produto
rating	Nota da avaliação (1 a 5)
helpful	Mais marcadas como úteis
unhelpful	Mais marcadas como não úteis

Resposta

{
  "results": [
    {
      "_id": "658310dd5c26870012a0d06a",
      "created": "2023-12-20T16:05:49.246Z",
      "customer": "konfidency",
      "rating": 5,
      "text": "Produtos de ótima qualidade e ótimo atendimento.",
      "name": "Tony S"
    }
  ]
}

Campos

campo	descrição	tipo de dados
_id	ID da avaliação
created	Data de envio da avaliação	string (data em formato ISO-8601)
customer	ID do cliente	string
rating	Nota da avaliação	integer
text	Texto da avaliação	string
name	Nome do consumidor	string

Carrossel de avaliações de loja

Obtém os dados para exibição do carrosel das avaliações de loja (últimas 10 avaliações mais positivas)

GET /{customer}/store-reviews/carousel

Parâmetros de URL

Parâmetro	Descrição
customer	Fornecido pelo nosso time de integração

Resposta

[
  {
    "_id": "658310dd5c26870012a0d06f",
    "created": "2023-12-20T16:05:49.246Z",
    "customer": "utilplast",
    "rating": 5,
    "text": "sempre contei com os produtos de boa qualidade.",
    "name": "Tony S"
  }
]

Campos

campo	descrição	tipo de dados
_id	ID da avaliação	string
created	Data de envio da avaliação	string (data em formato ISO-8601)
customer	ID do cliente	string
rating	Nota da avaliação	integer
text	Texto da avaliação	string
name	Nome do consumidor	string

Endpoints de Perguntas e respostas

Obter perguntas e respostas

Obtém os dados das perguntas e respostas sobre o produto. Este endpoint não suporta paginação, a mesma deve ser realizada no front-end.

GET /{customer}/{sku}/questions

Parâmetros de URL

Parâmetro	Descrição
customer	Fornecido pelo nosso time de integração
sku	SKU do produto

Resposta

[
  {
    "_id": "67241b3604ec400011b5be8b",
    "status": "published",
    "created": "2024-11-01T00:05:10.763Z",
    "name": "André Barbosa",
    "text": "Qual o material da camiseta?",
    "reply": {
      "created": "2024-11-01T00:05:51.253Z",
      "unhelpful": 0,
      "helpful": 0,
      "text": "Olá André!\n\nNossa camiseta é feita de 93% de algodão egípcio certificado e 7% de elastano para maior flexibilidade e resistência da peça.\n\n*A camiseta de cor mescla possui 80% de Algodão Egípcio 13% de poliéster e 7% de Elastano."
    }
  },
  {
    "_id": "67241b1a04ec400011b5bd58",
    "status": "published",
    "created": "2024-11-01T00:04:42.518Z",
    "name": "Eduardo Lima",
    "text": "Como eu sei o tamanho que vai servir em mim?",
    "reply": {
      "created": "2024-11-01T00:06:19.069Z",
      "unhelpful": 0,
      "helpful": 0,
      "text": "Olá Eduardo, tudo bem?\n\nUtilize o nosso provador virtual e deixe que o nosso sistema te indique o tamanho perfeito para o seu corpo!\n\nÉ só clicar em \"Descubra meu tamanho\" logo abaixo da seleção do tamanho da Camiseta.\n\nSe mesmo assim você quiser ver as medidas dos nossos produtos, é só acessar a tabela de medidas que está nas fotos do produto."
    }
  },
  {
    "_id": "67241ad6c649760012cbf7a5",
    "status": "published",
    "created": "2024-11-01T00:03:34.924Z",
    "name": "Caio Fernandes",
    "text": "Se eu pedir o tamanho errado eu posso trocar?",
    "reply": {
      "created": "2024-11-01T00:06:44.585Z",
      "unhelpful": 0,
      "helpful": 0,
      "text": "Boa noite Caio!\n\nSim! Fazemos as trocas de Camisetas em até 30 dias. Para solicitar a troca basta entrar em contato com a nossa equipe pelo Whatsapp."
    }
  }
]

Enviar pergunta

Envia uma pergunta para um produto

POST /{customer}/{sku}/question

Parâmetros de URL

Parâmetro	Descrição
customer	Fornecido pelo nosso time de integração
sku	SKU do produto

Campos do corpo da requisição (JSON)

campo	descrição	tipo de dados
userId	ID do usuário em sua plataforma	string
email	e-mail do usuário em sua plataforma	string
text	texto da pergunta do cliente	string

info

Os campos userId e email serão utilizados como chave composta para garantir que o usuário está autenticado corretamente na plataforma e não permitir atribuir avaliações a outros usuários

info

As perguntas precisam ser aprovadas e/ou respondidas através de nosso dashboard antes de serem publicadas em sua loja.