getProductsPriceByPageUrl

Pesquise informações sobre produtos e preços para a categoria selecionada.

Descrição

Este método busca informações sobre produtos e preços para a categoria selecionada, com base nos parâmetros de consulta fornecidos (userQuery). Ele retorna uma Promise que resolve para um objeto IProductsInfo.

Produtos.getProductsPriceByPageUrl( url, langCode, userQuery );

Esquema de parâmetros

Esquema

url: string
URL da página
exemplo: "23-laminat-floorwood-maxima"

langCode: string
Código do idioma. Padrão: "en_US"
exemplo: "en_US"

userQuery: IProductsPriceQuery
Conjunto de parâmetros de consulta opcionais
exemplo:

{
  "limit": 30,
  "offset": 0,
  "sortOrder": "DESC",
  "signPrice": "orders",
  "statusMarker": "in_stock"
}

userQuery.offset: number
Parâmetro para paginação. Padrão: 0.

userQuery.limit: number
Parâmetro para paginação. Padrão: 30.

userQuery.sortOrder: string
Ordem de classificação "DESC" | "ASC". Padrão: "DESC".

userQuery.signPrice: string
Marcador de armazenamento de pedido para fixação de preço.

userQuery.statusMarker: string | null
Marcador de status da página do produto, padrão nulo.
exemplo: "in_stock"

Por padrão, você pode recuperar 10 objetos. Isso se deve ao limite de registro nas configurações de permissões do módulo.
Para que a paginação funcione corretamente, você precisa configurar as Permissões do módulo de acordo com suas necessidades na seção correspondente.

💲 signPrice bloqueia o preço retornado por um tempo limitado — defina-o como seu marcador de armazenamento de pedidos. Veja Fixação do preço (signPrice).

Exemplos

Exemplo mínimo

const response = await Products.getProductsPriceByPageUrl('catalog');

Exemplo com atributos

const userQuery = {
  "offset": 0,
  "limit": 30,
  "statusMarker": "in_stock",
  "conditionValue": "new",
  "conditionMarker": "equals",
  "attributeMarker": "color",
  "sortOrder": "DESC",
  "sortKey": "id",
};

const response = await Products.getProductsPriceByPageUrl('catalog', 'en_US', userQuery);

Use filtros para encontrar produtos específicos:

attributeMarker: O identificador de texto do atributo indexado pelo qual os valores são filtrados. conditionMarker: O tipo de condição a ser aplicada ao valor do atributo.

Marcador	Significado	Exemplo
eq	Igual	statusId = 1 (apenas ativo)
neq	Não igual	role ≠ "Viewer"
in	Contém (um dos)	role in ["Editor", "Manager"]
nin	Não contém	email not in ["@temp.com"]
exs	Existe (tem valor)	Tem lastLogin
nexs	Não existe	Nunca fez login
pat	Corresponde ao padrão	identificador corresponde a "man"
same	Corresponde exatamente ao valor	identificador é exatamente "admin1"
same_part	Corresponde a uma parte do valor exatamente	parte do identificador é exatamente "adm"

conditionValue: O valor a ser comparado.

Exemplo de resposta

{
  "items": [
    {
      "id": 2960,
      "price": 180
    },
    {
      "id": 3445,
      "price": 150
    },
    {
      "id": 2957,
      "price": 150
    },
    "..."
  ],
  "total": 6
}

Esquema de resposta

Esquema: IProductsInfo

total: number
O número total de produtos encontrados.
exemplo: 100

items: IProductInfo[]
Um array de objetos de informações do produto.
exemplo:

[
  {
    "id": 12345,
    "price": 150
  },
  {
    "id": 67890,
    "price": 200
  }
]

items.id: number
O identificador único do produto.
exemplo: 12345

items.price: number
O preço do produto.
exemplo: 150

items.signedPrice: string
O preço assinado (fixo) do produto, retornado quando signPrice está definido.
veja: Preço fixo do produto
exemplo: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

---