Engage / API v1
Produtos

Buscar por SKU

Retorna os dados completos de um produto a partir do seu SKU.

GET/v1/products/sku/:sku

Útil quando o seu sistema usa o SKU como identificador interno. A busca é feita exatamente pelo valor enviado — diferenças de maiúsculas, espaços ou pontuação importam. A resposta tem o mesmo formato da busca por ID.

Obrigatório

Apenas o parâmetro de path sku é obrigatório. Não há body nem query string.

Exemplo

http
GET /v1/products/sku/PROD-001

Parâmetros de path

  • skustringobrigatório
    Código único do produto, conforme cadastrado no campo sku durante a criação. Caracteres especiais devem ser URL-encoded.

Campos da resposta

  • idstringopcional
    Identificador único do produto.
  • skustringopcional
    Código único do produto.
  • namestringopcional
    Nome do produto.
  • descriptionstring | nullopcional
    Descrição livre, ou null se não foi preenchida.
  • pricenumberopcional
    Preço em decimal.
  • createdAtstring (ISO 8601)opcional
    Data e hora de criação.
  • customFieldsobjectopcional
    Mapa { <nome do campo>: valor } com os campos customizados preenchidos.