API

Produtos

Endpoints para gerenciar produtos da loja

📋 Listar Produtos

GET/guilds/{guildId}/products

Query Params

Prop

Type

Resposta

[
  {
    "id": "clx...",
    "reference": "camiseta-preta",
    "title": "Camiseta Preta",
    "description": "Camiseta 100% algodão",
    "price": "49.90",
    "status": "ACTIVED",
    "category": "Roupas",
    "sell": true,
    "promotion": false
  }
]

🔍 Buscar Produto

GET/guilds/{guildId}/products/{id}

Também é possível buscar pela referência:

GET/guilds/{guildId}/products/by-reference/{reference}

✨ Criar Produto

POST/guilds/{guildId}/products

Body

Prop

Type

Exemplo

{
  "reference": "camiseta-preta",
  "createdBy": "123456789012345678",
  "title": "Camiseta Preta",
  "price": 49.90,
  "sell": true,
  "coupon": true
}

✏️ Atualizar Produto

PATCH/guilds/{guildId}/products/{id}

Todos os campos são opcionais.

Prop

Type


🗑️ Deletar Produto

DELETE/guilds/{guildId}/products/{id}

🔢 Contar Produtos

GET/guilds/{guildId}/products/count
{ "count": 42 }

Produtos com status: "BANNED" não aparecem para clientes, mas ficam nos registros históricos.