setWishlist

Substitua a lista de desejos do usuário atual ou do convidado. 🔐 Este método requer autorização (ou um contexto de convidado).

Descrição

Este método substitui toda a lista de desejos do contexto atual - um usuário autorizado ou um convidado (resolvido via o cabeçalho x-guest-id, veja Modo convidado) - pelos itens fornecidos. Ele retorna uma Promise que resolve para o objeto IWishlistResponse atualizado.

Users.setWishlist(

body*, body.items*

);

Esquema de parâmetros

Esquema

body(obrigatório): IWishlistSet
Novos conteúdos da lista de desejos. Exemplo: { items: [{ productId: 1 }] }

body.items(obrigatório): IWishlistItem[]
Novos itens da lista de desejos.

body.items.productId(obrigatório): number
Identificador do produto.
exemplo: 1

Exemplos

Exemplo mínimo

const response = await Users.setWishlist({
  items: [{ productId: 1 }],
});

Exemplo de resposta

{
  "items": [
    {
      "productId": 1,
      "addedAt": "2026-05-30T10:00:00.000Z"
    }
  ],
  "total": 1
}

Esquema de resposta

Esquema: IWishlistResponse

items: IWishlistItem[]
Itens da lista de desejos.

items.productId: number
Identificador do produto.
exemplo: 1

items.addedAt: string
Data ISO quando o item foi adicionado.
exemplo: "2026-05-30T10:00:00.000Z"

total: number
Número total de itens na lista de desejos.
exemplo: 3

---