Acesso Comercial / Docs / Office / API
Ctrl K
QUERY

product

Busca um produto por ID global. Requer permissão products:read.

Assinatura

query {
  product(id: ID!): Product

Parâmetros

CampoTipoObrigatórioDescrição
idID!SimID global do produto (formato Relay Global ID).

Retorno

Retorna um objeto Product com todos os campos solicitados, ou null se não encontrado.

Campos Disponíveis

Selecione apenas os campos necessários para otimizar a resposta. Campos comuns:

CampoTipoDescrição
idIDID global do produto.
titleStringNome do produto.
descriptionStringDescrição.
priceFloatPreço de venda.
availableQuantityIntQuantidade em estoque.
isActiveBooleanStatus ativo/inativo.
images[Image]Array com URLs das imagens.
section[String]Seção/departamento.
brandStringMarca.
createdAtStringData de criação (ISO 8601).
updatedAtStringData da última atualização.

Buscar Produto

GraphQL
query {
  product(id: "UHJvZHVjdDo2MTIz...") {
    id
    title
    description
    price
    availableQuantity
    isActive
    images {
      url
    }
    section
    brand
    createdAt
  }
}

Resposta

JSON
{
  "data": {
    "product": {
      "id": "UHJvZHVjdDo2MTIz...",
      "title": "Camiseta Azul",
      "description": "100% algodão",
      "price": 49.90,
      "availableQuantity": 100,
      "isActive": true,
      "images": [
        { "url": "https://cdn.../camiseta.jpg" }
      ],
      "section": ["Roupas"],
      "brand": "Nike",
      "createdAt": "2025-01-15T..."
    }
  }
}