Excluir produto
Exclui um produto do seller; ele sai do catálogo e das listas.
A exclusão é lógica: o produto some das listas, da vitrine e da busca, mas o histórico de pedidos que o citam continua intacto. O registro de quem excluiu e quando fica na auditoria da loja. Para tirar o produto do ar sem perdê-lo, prefira alterar o status para D ou H.
/api/v1/vendor/products/{id}SellerExcluir um produto
Cabeçalhos
AuthorizationstringobrigatórioBearer $TOKEN. Token de acesso do usuário seller (veja Tokens).Parâmetros de caminho
idstring (uuid)obrigatórioId do produto.
Exemplo de requisição
bash
curl -X DELETE "$BASE_URL/api/v1/vendor/products/$PRODUCT_ID" \
-H "Authorization: Bearer $TOKEN"Resposta
200Produto excluído
json
{
"message": "product deleted"
}Campos da resposta
messagestringConfirmação fixa.
Erros
| Status | Quando | Corpo |
|---|---|---|
| 401 | Token ausente, inválido ou expirado. | {"error":"missing authorization header"} |
| 403 | Token que não é de seller, ou usuário sem o privilégio exigido pela rota. | {"error":"insufficient vendor privileges","privilege_required_any":["vendor_catalog"]} |
| 403 | O produto existe mas é de outro seller (ou da loja). | {"error":"you do not have access to this product"} |
| 404 | Produto não existe. | {"error":"product not found"} |
| 500 | Falha ao excluir. | {"error":"failed to delete product","detail":"..."} |