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
Resposta
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.