Produtos do selo
Lista os produtos que têm um selo e liga ou desliga produtos à mão.
A ligação manual diz exatamente em quais produtos o selo aparece. Serve para campanhas pontuais ("Dia das Mães") e para destacar produtos escolhidos. Quando o selo está em modo regra, a lista é mantida pela plataforma, e ligar à mão aqui ainda é possível, mas veja o aviso abaixo. O módulo product-stickers precisa estar ligado.
/api/v1/admin/stickers/{id}/productsAdminLista os produtos com o selo
Devolve todos os produtos ligados ao selo (por regra ou à mão), sem paginação.
Parâmetros de caminho
iduuidobrigatório/api/v1/admin/stickers/{id}/productsAdminLiga um produto ao selo
Liga um produto. Repetir a chamada para um produto já ligado não dá erro e não duplica.
Parâmetros de caminho
iduuidobrigatórioCorpo da requisição (JSON)
product_iduuidobrigatório/api/v1/admin/stickers/{id}/products/{product_id}AdminDesliga um produto do selo
Remove a ligação. Desligar um produto que não estava ligado não dá erro.
Parâmetros de caminho
iduuidobrigatórioproduct_iduuidobrigatórioExemplo de requisição
curl -X POST "$BASE_URL/api/v1/admin/stickers/$STICKER/products" \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d '{"product_id":"c3f92551-9dda-4fc7-b518-353d1c4e4035"}'
curl -X DELETE "$BASE_URL/api/v1/admin/stickers/$STICKER/products/c3f92551-9dda-4fc7-b518-353d1c4e4035" \
-H "Authorization: Bearer $TOKEN"Resposta
{
"products": [
{
"id": "c3f92551-9dda-4fc7-b518-353d1c4e4035",
"name": "Notebook Slim Rosa 02373",
"slug": "notebook-slim-rosa-02373-2373",
"sku": "SD-002373",
"price": 249900,
"image_url": "/uploads/exemplo/product/notebook.png",
"attached_at": "2026-10-11T21:09:15Z"
}
]
}{ "message": "attached" }{ "message": "detached" }Campos de cada produto
iduuidnamestringslugstringskustringpriceintegerimage_urlstringattached_atstringErros
| Status | Quando | Corpo de exemplo |
|---|---|---|
| 400 | product_id ausente | {"error":"product_id is required"} |
| 400 | product_id que não é um UUID | {"error":"failed to attach product","detail":"o valor \"nope\" não é um uuid válido. ..."} |
| 400 | Corpo que não é JSON | {"error":"invalid request body","detail":"..."} |
| 401 | Token ausente ou expirado | {"error":"invalid or expired token"} |
| 403 | Módulo desligado | {"error":"module_disabled","module":"product-stickers"} |
| 500 | id do selo que não é UUID | {"error":"failed to list products","detail":"..."} |
A mensagem de UUID inválido vem em português do servidor.