Lista de desejos
O que é a lista de desejos, o formato dos ids e preços e o mapa das três operações /wishlists.
A lista de desejos guarda os produtos que um cliente marcou para comprar depois. A vitrine mostra a lista para o próprio cliente; estas rotas deixam um sistema externo (app, CRM, ferramenta de e-mail marketing) ler a lista, adicionar um produto ou remover outro, com o contrato da API 1.0.
Como funciona
Abas
A API 1.0 original organizava a lista em abas. Aqui existe uma única aba, chamada default (nome Wishlist). Os valores de scope get_tabs e get_wishlist continuam aceitos para que clientes antigos funcionem sem mudanças.
Fluxo típico
- Ler a lista
Listar a lista de desejos com o
user_iddo cliente. - Adicionar um produto
Adicionar produto com
user_ideproduct_id. - Remover
Remover produto quando o cliente desistir do item.
Endpoints
| Método | Caminho | Para que serve | Autenticação |
|---|---|---|---|
| GET | /api/v1.0/wishlists | Listar a lista de desejos | Credencial válida |
| POST | /api/v1.0/wishlists | Adicionar produto | Credencial válida |
| DELETE | /api/v1.0/wishlists | Remover produto | Credencial válida |
Erros comuns
- Esquecer o
user_id. Responde 400user_id is required. - Mandar um id que não é UUID. Um
user_idfora do formato UUID volta como 500. - Mandar o
product_idno corpo doDELETE. ODELETElêuser_ideproduct_idda query string. - Remover um item que não está na lista. Responde 500 com
item not found in wishlist, não 404. - Esperar mais de 250 itens por página. Valores acima de 250 voltam ao padrão de 10.