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

Excluir um carrinho

Exclui o carrinho de compras de um usuário, para limpar carrinhos abandonados ou reiniciar a sessão de compra de um cliente.

Este endpoint exclui o carrinho de compras de um usuário da sua loja Venddor. Ele serve para limpar carrinhos abandonados ou para reiniciar a sessão de compra de um cliente. Envie uma requisição DELETE com o id do usuário no caminho; por exemplo, DELETE /api/carts/3 exclui o carrinho do usuário com user_id=3.

Cuidado

Excluir um carrinho é permanente e não pode ser desfeito. Confirme que você tem um backup, ou que tem certeza de que quer remover o carrinho, antes de prosseguir.

DELETE/api/carts/{user_id}Admin

Excluir o carrinho associado a um id de usuário

Parâmetros de caminho

user_idintegerobrigatório
O identificador único do usuário cujo carrinho você quer excluir.

Exemplo de requisição

bash
curl -X DELETE -u "$EMAIL:$API_KEY" "$BASE_URL/api/carts/3"

Resposta

O endpoint não devolve conteúdo quando a exclusão dá certo, apenas um código de status que indica sucesso.

Código de statusDescrição
204 No ContentO carrinho foi excluído com sucesso.
404 Not FoundO carrinho informado não existe ou já foi excluído.

Notas de implementação

Ao usar o endpoint de exclusão, considere estes casos de uso e boas práticas.

  • Use-o para limpar carrinhos abandonados depois de um certo período de inatividade.
  • Implemente a exclusão do carrinho como parte dos processos de encerramento de conta do usuário.
  • Limpe os carrinhos quando o usuário concluir uma compra, para preparar a próxima sessão de compra.
  • Considere fazer um backup dos dados do carrinho antes da exclusão se você precisar deles para análises.
Dica

Se você só quer esvaziar um carrinho em vez de excluí-lo por completo, considere usar uma requisição PUT para atualizar o carrinho com um array de produtos vazio.

Veja também

  • Obter um carrinho
  • Listar carrinhos
Anterior
Detalhes do carrinho
Próxima
Propostas de preço
Nesta página
  • Exemplo de requisição
  • Resposta
  • Notas de implementação
  • Veja também