Cancelar alerta de preço
Cancela um alerta de preço, o aviso por e-mail que o comprador pediu para quando um produto chegar a um preço-alvo.
Na página de um produto o comprador pode pedir "avise-me quando custar até R$ X". Isso cria um alerta de preço ligado a um e-mail. Quando o preço cai até o alvo, a loja envia o aviso. Esta rota cancela o alerta. Ela é a que o link "parar de receber este aviso" do e-mail usa e também serve para uma tela "Meus alertas".
O alerta é criado por POST /api/v1/storefront/products/{id}/price-alerts (rota da página de produto, fora desta seção), que devolve {"id": "...", "status": "active"}. Guarde esse id.
/api/v1/storefront/price-alerts/{id}PúblicaCancel a price alert
Marca o alerta como cancelled. A rota é pública: a prova de que o chamador pode cancelar é conhecer o id do alerta e o e-mail dele. Cliente logado pode omitir email: usa-se o e-mail da conta.
Parâmetros de caminho
iduuidobrigatórioParâmetros de consulta
emailstringExemplo de requisição
curl -X DELETE "$BASE_URL/api/v1/storefront/price-alerts/$ALERT_ID?email=maria.souza@example.com"Resposta
{ "cancelled": true }Campos da resposta
cancelledbooleantrue quando a chamada termina sem erro.Erros
| Status | Quando | Corpo |
|---|---|---|
| 400 | Sem email (e sem login) | {"error":"id and email required"} |
| 500 | O id não é um UUID válido | {"error":"failed to cancel alert","detail":"o valor \"not-a-uuid\" não é um uuid válido. ..."} |