API atual/Referência completa/Selos, kits, mixes e caixas

Selos nos produtos

Lista os produtos com um selo, coloca o selo em um produto e o retira.

É a ligação entre um selo e os produtos que o exibem. A operação é idempotente: colocar duas vezes não duplica, e tirar um selo que o produto não tem também responde sucesso.

Listar

GET/api/v1/vendor/stickers/{id}/productsSeller

Listar produtos com o selo

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso do usuário seller (veja Tokens).

Parâmetros de caminho

idstring (uuid)obrigatório

Id do selo.

Exemplo de requisição (listar)

bash

curl "$BASE_URL/api/v1/vendor/stickers/$STICKER_ID/products" \
  -H "Authorization: Bearer $TOKEN"

Resposta (listar)

200Produtos

json

{
  "products": [
    {
      "id": "7bc1d5e9-a9a4-457b-866f-bbb3879d258d",
      "name": "Camiseta Básica Algodão Preta",
      "slug": "camiseta-basica-algodao-preta",
      "sku": "CAM-001",
      "price": 4990,
      "image_url": "/uploads/dfe2555e/camiseta.png",
      "attached_at": "2026-10-11T20:30:00Z"
    }
  ]
}

Campos da resposta

productsarray

Produtos com o selo.

idstring (uuid)

Produto.

namestring

Nome.

slugstring

Slug.

skustring

SKU.

priceinteger

Preço em centavos.

image_urlstring

Imagem.

attached_atstring

Quando o selo foi colocado (RFC 3339).

Erros (listar)

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_settings"]}`
404	O selo não existe ou não é seu.	`{"error":"sticker not found"}`

Colocar

POST/api/v1/vendor/stickers/{id}/productsSeller

Colocar o selo em um produto

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso do usuário seller (veja Tokens).

Parâmetros de caminho

idstring (uuid)obrigatório

Id do selo.

Corpo da requisição

product_idstring (uuid)obrigatório

Produto que receberá o selo.

Exemplo de requisição (colocar)

bash

curl -X POST "$BASE_URL/api/v1/vendor/stickers/$STICKER_ID/products" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "product_id": "7bc1d5e9-a9a4-457b-866f-bbb3879d258d"
}'

Resposta (colocar)

201Selo colocado

json

{
  "message": "attached"
}

Campos da resposta

messagestring

Confirmação fixa.

Erros (colocar)

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_settings"]}`
404	O selo não existe ou não é seu.	`{"error":"sticker not found"}`
400	`product_id` ausente, ou produto que não existe.	`{"error":"product_id is required"}`

Tirar

DELETE/api/v1/vendor/stickers/{id}/products/{productId}Seller

Tirar o selo de um produto

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso do usuário seller (veja Tokens).

Parâmetros de caminho

idstring (uuid)obrigatório

Id do selo.

productIdstring (uuid)obrigatório

Produto.

Exemplo de requisição (tirar)

bash

curl -X DELETE "$BASE_URL/api/v1/vendor/stickers/$STICKER_ID/products/$PRODUCT_ID" \
  -H "Authorization: Bearer $TOKEN"

Resposta (tirar)

200Selo retirado

json

{
  "message": "detached"
}

Campos da resposta

messagestring

Confirmação fixa. Também vale se o produto não tinha o selo.

Erros (tirar)

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_settings"]}`
404	O selo não existe ou não é seu.	`{"error":"sticker not found"}`

Veja também

Vitrine e ofertas: visão geral

API atual/Referência completa/Selos, kits, mixes e caixas

Selos nos produtos

Lista os produtos com um selo, coloca o selo em um produto e o retira.

É a ligação entre um selo e os produtos que o exibem. A operação é idempotente: colocar duas vezes não duplica, e tirar um selo que o produto não tem também responde sucesso.

Listar

GET/api/v1/vendor/stickers/{id}/productsSeller

Listar produtos com o selo

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso do usuário seller (veja Tokens).

Parâmetros de caminho

idstring (uuid)obrigatório

Id do selo.

Exemplo de requisição (listar)

bash

curl "$BASE_URL/api/v1/vendor/stickers/$STICKER_ID/products" \
  -H "Authorization: Bearer $TOKEN"

Resposta (listar)

200Produtos

json

{
  "products": [
    {
      "id": "7bc1d5e9-a9a4-457b-866f-bbb3879d258d",
      "name": "Camiseta Básica Algodão Preta",
      "slug": "camiseta-basica-algodao-preta",
      "sku": "CAM-001",
      "price": 4990,
      "image_url": "/uploads/dfe2555e/camiseta.png",
      "attached_at": "2026-10-11T20:30:00Z"
    }
  ]
}

Campos da resposta

productsarray

Produtos com o selo.

idstring (uuid)

Produto.

namestring

Nome.

slugstring

Slug.

skustring

SKU.

priceinteger

Preço em centavos.

image_urlstring

Imagem.

attached_atstring

Quando o selo foi colocado (RFC 3339).

Erros (listar)

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_settings"]}`
404	O selo não existe ou não é seu.	`{"error":"sticker not found"}`

Colocar

POST/api/v1/vendor/stickers/{id}/productsSeller

Colocar o selo em um produto

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso do usuário seller (veja Tokens).

Parâmetros de caminho

idstring (uuid)obrigatório

Id do selo.

Corpo da requisição

product_idstring (uuid)obrigatório

Produto que receberá o selo.

Exemplo de requisição (colocar)

bash

curl -X POST "$BASE_URL/api/v1/vendor/stickers/$STICKER_ID/products" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "product_id": "7bc1d5e9-a9a4-457b-866f-bbb3879d258d"
}'

Resposta (colocar)

201Selo colocado

json

{
  "message": "attached"
}

Campos da resposta

messagestring

Confirmação fixa.

Erros (colocar)

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_settings"]}`
404	O selo não existe ou não é seu.	`{"error":"sticker not found"}`
400	`product_id` ausente, ou produto que não existe.	`{"error":"product_id is required"}`

Tirar

DELETE/api/v1/vendor/stickers/{id}/products/{productId}Seller

Tirar o selo de um produto

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso do usuário seller (veja Tokens).

Parâmetros de caminho

idstring (uuid)obrigatório

Id do selo.

productIdstring (uuid)obrigatório

Produto.

Exemplo de requisição (tirar)

bash

curl -X DELETE "$BASE_URL/api/v1/vendor/stickers/$STICKER_ID/products/$PRODUCT_ID" \
  -H "Authorization: Bearer $TOKEN"

Resposta (tirar)

200Selo retirado

json

{
  "message": "detached"
}

Campos da resposta

messagestring

Confirmação fixa. Também vale se o produto não tinha o selo.

Erros (tirar)

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_settings"]}`
404	O selo não existe ou não é seu.	`{"error":"sticker not found"}`

Veja também

Vitrine e ofertas: visão geral