Contar e verificar favoritos
Devolve quantos produtos há na lista de desejos e se um produto específico está nela.
Duas consultas leves para a interface: o número do ícone de favoritos no cabeçalho e o estado do coração (cheio ou vazio) na página de produto ou nos cards de uma vitrine.
Contar
/api/v1/storefront/wishlist/countClienteQuantidade de favoritos do cliente
Cabeçalhos
AuthorizationstringobrigatórioBearer $TOKEN de um cliente logado.Exemplo de requisição
bash
curl "$BASE_URL/api/v1/storefront/wishlist/count" \
-H "Authorization: Bearer $TOKEN"Resposta
200Contagem
json
{"count": 3}Campos da resposta
countintegerQuantos produtos estão gravados na lista, inclusive os que deixaram de estar ativos.
Verificar um produto
/api/v1/storefront/wishlist/{productId}/checkClienteDiz se um produto está na lista
Parâmetros de caminho
productIduuidobrigatórioId do produto (UUID completo).
Exemplo de requisição
bash
curl "$BASE_URL/api/v1/storefront/wishlist/5e833a7f-1a77-402c-835a-32594350d7a7/check" \
-H "Authorization: Bearer $TOKEN"Resposta
200Estado do produto
json
{"in_wishlist": true, "product_id": "5e833a7f-1a77-402c-835a-32594350d7a7"}Campos da resposta
in_wishlistbooleantrue se o produto está na lista do cliente.product_iduuidO id consultado.
Erros
| Status | Quando | Corpo de exemplo |
|---|---|---|
| 400 | productId não é um UUID. | {"error":"invalid product_id","detail":"product_id must be a valid UUID"} |
| 401 | Sem token. | {"error":"missing authorization header"} |
| 403 | A loja não tem o módulo, ou a chave de API não tem customer:read. | {"error":"feature_not_available","feature":"wishlist","detail":"switched off for this store"} |