API atual/Referência completa/Avaliações e perguntas

GETProva social

Devolve os selos de venda e urgência de um produto, já filtrados pelas regras da loja.

Selos como "128 vendidos em 30 dias", "6 vendidos hoje", "restam só 3" e "a oferta termina em 2 dias" aumentam a conversão. Esta rota calcula esses números a partir de pedidos, estoque e promoções reais, e devolve em badges somente os selos que a loja ligou e cujo mínimo foi atingido. Mostre exatamente o que vem em badges.

Com todos os selos desligados na loja, a resposta é barata e traz badges vazio. Pode ser guardada em cache por 5 minutos.

GET/api/v1/storefront/products/{id}/social-proofPública

Selos de prova social de um produto

Parâmetros de caminho

iduuidobrigatório

Id do produto (UUID completo).

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/storefront/products/5e833a7f-1a77-402c-835a-32594350d7a7/social-proof"

Resposta

200Selos retornados

json

{"sold_30d":128,"sold_today":6,"low_stock_qty":3,"promo_ends_at":"2026-10-13T23:59:00Z","badges":["sold_30d","sold_today","low_stock","promo_countdown"]}

Loja com os selos desligados (resposta real da loja de teste):

200Sem selos

json

{"sold_30d":0,"sold_today":0,"low_stock_qty":null,"promo_ends_at":null,"badges":[]}

Campos da resposta

sold_30dinteger

Unidades vendidas nos últimos 30 dias. Só vem preenchido quando o selo sold_30d está em badges; senão é 0.

sold_todayinteger

Unidades vendidas hoje. Só preenchido com o selo sold_today.

low_stock_qtyinteger

Unidades em estoque, quando o saldo é positivo e abaixo do limite da loja. null caso contrário.

promo_ends_atstring

Fim da promoção ativa que termina primeiro, se acaba em até 72 horas, RFC 3339 em UTC. null caso contrário.

badgesarray

Selos a mostrar, entre sold_30d, sold_today, low_stock e promo_countdown.

Erros

Status	Quando	Corpo de exemplo
401	A loja exige login para navegar.	`{"error":"shopping_requires_login","message":"this storefront requires login to browse"}`
500	O id não é um UUID válido.	`{"error":"failed to compute social proof","detail":"o valor \"abc\" não é um uuid válido. Envie o identificador completo, com os 36 caracteres e os hífens. Corrija o campo e reenvie."}`

Veja também

GETProva social

Devolve os selos de venda e urgência de um produto, já filtrados pelas regras da loja.

Com todos os selos desligados na loja, a resposta é barata e traz badges vazio. Pode ser guardada em cache por 5 minutos.

GET/api/v1/storefront/products/{id}/social-proofPública

Selos de prova social de um produto

Parâmetros de caminho

iduuidobrigatório

Id do produto (UUID completo).

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/storefront/products/5e833a7f-1a77-402c-835a-32594350d7a7/social-proof"

Resposta

200Selos retornados

json

{"sold_30d":128,"sold_today":6,"low_stock_qty":3,"promo_ends_at":"2026-10-13T23:59:00Z","badges":["sold_30d","sold_today","low_stock","promo_countdown"]}

Loja com os selos desligados (resposta real da loja de teste):

200Sem selos

json

{"sold_30d":0,"sold_today":0,"low_stock_qty":null,"promo_ends_at":null,"badges":[]}

Campos da resposta

sold_30dinteger

Unidades vendidas nos últimos 30 dias. Só vem preenchido quando o selo sold_30d está em badges; senão é 0.

sold_todayinteger

Unidades vendidas hoje. Só preenchido com o selo sold_today.

low_stock_qtyinteger

Unidades em estoque, quando o saldo é positivo e abaixo do limite da loja. null caso contrário.

promo_ends_atstring

Fim da promoção ativa que termina primeiro, se acaba em até 72 horas, RFC 3339 em UTC. null caso contrário.

badgesarray

Selos a mostrar, entre sold_30d, sold_today, low_stock e promo_countdown.

Erros

Status	Quando	Corpo de exemplo
401	A loja exige login para navegar.	`{"error":"shopping_requires_login","message":"this storefront requires login to browse"}`
500	O id não é um UUID válido.	`{"error":"failed to compute social proof","detail":"o valor \"abc\" não é um uuid válido. Envie o identificador completo, com os 36 caracteres e os hífens. Corrija o campo e reenvie."}`