VenddorDocumentação API
API atualAPI legada
Guia rápidoReferência completa
Carregando índice…
API atual/Referência completa/Recomendações e compartilhamento

Quem viu também viu

Devolve os produtos que os visitantes costumam ver na mesma sessão em que veem um produto.

Use esta rota na página do produto para o carrossel "Quem viu este produto também viu". O sinal vem das visualizações que a vitrine registra com Registrar visualizações: produtos vistos na mesma sessão de navegação ganham score. Sem essas chamadas a lista fica vazia. O formato é o mesmo de Quem comprou também levou.

GET/api/v1/storefront/products/{id}/also-viewedPública

Quem viu também viu

Parâmetros de caminho

idstringobrigatório
Id (UUID) ou slug do produto.

Parâmetros de consulta

limitintegerpadrão: 8
Quantidade de produtos. Máximo 50; acima disso vale 50. Zero, negativo ou texto voltam a 8.

Exemplo de requisição

bash
curl "$BASE_URL/api/v1/storefront/products/camiseta-lite-verde-00146-146/also-viewed?limit=4"

Resposta

200Produtos vistos juntos
json
{
  "recommendations": [
    {
      "product": {
        "id": "4272b05b-b7c0-435b-bb78-a26e00f08f8f",
        "name": "Camiseta Clássico Bege 00711 - PROMOÇÃO",
        "slug": "camiseta-classico-bege-00711-711",
        "price": 9990,
        "list_price": null,
        "image_url": "/uploads/dfe2555e-bfd0-41a8-9fa1-9586999f3798/product/4272b05b-b7c0-435b-bb78-a26e00f08f8f/foto.png",
        "image_alt": "Camiseta Clássico Bege 00711",
        "rating_avg": 4.9,
        "rating_count": 2,
        "quantity": 3,
        "vendor_name": "Loja Seller Teste"
      },
      "score": 10
    }
  ],
  "total": 1
}

Campos da resposta

recommendationsarray
Itens recomendados, do maior para o menor score. Mesmos campos de Quem comprou também levou.
recommendations[].scoreinteger
Quantas sessões viram os dois produtos.
totalinteger
Quantidade de itens devolvidos.

Erros

StatusQuandoCorpo
400O caminho não traz id de produto{"error":"product ID is required"}
401A loja exige login para navegar e a chamada não tem token{"error":"shopping_requires_login","message":"this storefront requires login to browse"}
404O valor não é um UUID e nenhum produto tem esse slug{"error":"product not found"}
500Falha ao ler os dados{"error":"failed to get also-viewed recommendations","detail":"..."}
Atualização

Os pares de produtos são atualizados a cada visualização registrada. Mesmo assim, a resposta pode ser reaproveitada por até 5 minutos pelo navegador ou CDN, então o carrossel não muda na hora.

Veja também

  • Registrar visualizações
  • Quem comprou também levou
Anterior
Quem comprou também levou
Próxima
Registrar visualizações
Nesta página
  • Exemplo de requisição
  • Resposta
  • Erros
  • Veja também