VenddorDocumentação API
API atualAPI legada
Guia rápidoReferência completa
Carregando índice…
API legada/Referência completa/Lista de desejos

POSTAdicionar produto

Coloca um produto ativo na lista de desejos de um cliente.

Inclui um produto na lista de desejos de um cliente. A plataforma guarda o preço do produto no momento da inclusão e, se o produto já estava na lista, não faz nada e responde sucesso do mesmo jeito.

POST/api/v1.0/wishlistsAutenticada

Adicionar produto à lista de desejos

Corpo da requisição

user_iduuidobrigatório
Id do cliente.
product_iduuidobrigatório
Id do produto. O produto precisa existir e estar ativo.

Exemplo de requisição

bash
curl -u "$EMAIL:$API_KEY" -X POST "$BASE_URL/api/v1.0/wishlists" \
  -H "Content-Type: application/json" \
  -d '{"user_id":"3dc023ca-3746-4b6e-8afd-686a4a9af99f","product_id":"9f1c2a7e-5b34-4c1d-8a62-0d7e4b5c1a10"}'

Resposta

201Produto adicionado
json
{
  "product_id": "9f1c2a7e-5b34-4c1d-8a62-0d7e4b5c1a10",
  "user_id": "3dc023ca-3746-4b6e-8afd-686a4a9af99f"
}

Campos da resposta

product_iduuid
O produto informado.
user_iduuid
O cliente informado.

Erros

StatusQuandoCorpo de exemplo
400Corpo que não é JSON.{"message":"invalid request body","status":400}
400user_id ou product_id ausente.{"message":"user_id and product_id are required","status":400}
401Sem credencial.{"message":"Authentication required. Use HTTP Basic with email:api_key or Bearer <jwt>.","status":401}
404Produto inexistente ou inativo.{"message":"product not found or not active","status":404}
500user_id ou product_id que não é UUID.{"message":"...","status":500}
Repetir é seguro

Adicionar um produto que já está na lista responde 201 igual e não altera o preço guardado. Pode repetir a chamada depois de uma falha de rede.

Veja também

  • Listar a lista de desejos
  • Remover produto
Anterior
Listar lista de desejos
Próxima
Remover produto
Nesta página
  • Exemplo de requisição
  • Resposta
  • Erros
  • Veja também