Adicionar e remover favorito
Inclui ou retira um produto da lista de desejos do cliente logado.
O gesto de tocar no coração. Adicionar é idempotente: repetir a chamada não duplica nem dá erro. Remover um produto que não está na lista também responde sucesso.
Adicionar
/api/v1/storefront/wishlist/{productId}ClienteAdiciona um produto à lista de desejos
Sem corpo. Com chave de API, ela precisa do escopo customer:write.
Parâmetros de caminho
productIduuidobrigatórioId do produto (UUID completo).
Exemplo de requisição
bash
curl -X POST "$BASE_URL/api/v1/storefront/wishlist/5e833a7f-1a77-402c-835a-32594350d7a7" \
-H "Authorization: Bearer $TOKEN"Resposta
200Adicionado
json
{"message": "added to wishlist"}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:write. | {"error":"feature_not_available","feature":"wishlist","detail":"switched off for this store"} |
| 404 | O produto não existe. | {"error":"product not found"} |
Remover
/api/v1/storefront/wishlist/{productId}ClienteRemove um produto da lista de desejos
Parâmetros de caminho
productIduuidobrigatórioId do produto (UUID completo).
Exemplo de requisição
bash
curl -X DELETE "$BASE_URL/api/v1/storefront/wishlist/5e833a7f-1a77-402c-835a-32594350d7a7" \
-H "Authorization: Bearer $TOKEN"Resposta
200Removido
json
{"message": "removed from wishlist"}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:write. | {"error":"feature_not_available","feature":"wishlist","detail":"switched off for this store"} |
As mensagens message são devolvidas em inglês.