Produto

Endpoint público para parceiros consultarem o detalhe de um produto do catálogo a partir do seu slug.

Base URL

https://{sua-loja}/api/v2/public/

Autenticação

Endpoint público — não exige autenticação. Apenas produtos com status = ativo são retornados.

`GET /products/{slug}/`

Retorna o detalhe de um único produto a partir do slug da URL pública (a parte final do absolute_url, antes de /p).

Path params

Nome	Tipo	Descrição
`slug`	`string`	Slug do produto. Ex.: `camiseta-basica-branca-g`

Query params

Nome	Tipo	Descrição
`fl`	`string` (CSV)	Lista de campos a retornar. Se omitido, retorna o conjunto default.

Campos disponíveis em `fl`

Estes aliases podem ser usados em fl. Eles são traduzidos internamente para os campos do índice:

Alias público	Campo de resposta
`id`	`id`
`name`	`name`
`title`	`title`
`image`	`image`
`images` / `gallery`	`images`
`unit_price`	`unit_price`
`sale_price`	`sale_price`
`absolute_url`	`absolute_url`
`descont_percentage`	`descont_percentage`
`seals`	`seals`
`brand`	`brand`
`rating`	`rating`
`loyalty_price`	`loyalty_price`
`modals`	`modals`
`specifications`	`specifications`
`has_stock`	`has_stock`
`ean_13`	`ean_13`
`pbmpag_active`	`pbmpag_active`
`sku_default`	`sku_default`
`weight`	`weight`
`upc`	`upc`

O default quando fl é omitido:

id,name,title,rating,descont_percentage,specifications,brand,weight,
absolute_url,unit_price,sale_price,modals,seals,has_stock,images,upc,
ean_13,sku_default,loyalty_price,image,pbmpag_active

Exemplo — Request

curl "https://sua-loja.com/api/v2/public/products/camiseta-basica-branca-g/?fl=id,name,title,sale_price,images"

Exemplo — Response `200 OK`

{
  "id": "sku_12345",
  "name": "camiseta-basica-branca-g",
  "title": "Camiseta Básica Branca G",
  "sale_price": 79.90,
  "images": [
    { "image": "https://cdn.sua-loja.com/media/products/12345/front.jpg" },
    { "image": "https://cdn.sua-loja.com/media/products/12345/back.jpg" }
  ]
}

Respostas

Código	Corpo	Significado
`200`	objeto do produto	Produto encontrado.
`404`	`{"detail": "Produto não encontrado."}`	Slug inexistente ou produto inativo.

Observações

Campos JSON (images, specifications) são automaticamente decodificados no response.
URLs de imagens são retornadas já absolutas (o prefixo de mídia é aplicado pelo servidor).
Apenas produtos com status_s:2 (ativo) são retornáveis.
Os campos id e name são sempre incluídos no response, mesmo que omitidos em fl.