getProductsPriceByPageUrl

Recherchez des informations sur les produits et les prix pour la catégorie sélectionnée.

Description

Cette méthode recherche des informations sur les produits et les prix pour la catégorie sélectionnée, en fonction des paramètres de requête fournis (userQuery). Elle renvoie une promesse qui se résout en un objet IProductsInfo.

Produits.getProductsPriceByPageUrl( url, langCode, userQuery );

Schéma des paramètres

Schéma

url: string
URL de la page
exemple : "23-laminat-floorwood-maxima"

langCode: string
Code de langue. Par défaut : "en_US"
exemple : "en_US"

userQuery: IProductsQuery
Paramètres de requête optionnels
exemple :

{
  "limit": 30,
  "offset": 0,
  "sortOrder": "DESC",
  "sortKey": "id",
  "signPrice": "orders",
  "templateMarker": "template_12345",
  "statusMarker": "in_stock",
  "conditionValue": "new",
  "conditionMarker": "eq",
  "attributeMarker": "color"
}

userQuery.offset(required): number
Paramètre pour la pagination. Par défaut : 0.

userQuery.limit(required): number
Paramètre pour la pagination. Par défaut : 30.

userQuery.sortOrder(required): string
Ordre de tri "DESC" | "ASC". Par défaut : "DESC".

userQuery.sortKey(required): string
Champ pour le tri (par défaut - null). Valeurs possibles : "id", "position", "title", "date", "price". Par défaut : null.

userQuery.signPrice: string
Signe du prix. Par défaut : null.

userQuery.templateMarker: string | null
Marqueur de modèle de page produit, par défaut null.
exemple : "template_12345"

userQuery.statusMarker: string | null
Marqueur de statut de page produit, par défaut null.
exemple : "in_stock"

userQuery.conditionValue: string | null
La valeur recherchée, par défaut null.
exemple : "new"

userQuery.attributeMarker: string | null
L'identifiant textuel de l'attribut indexé par lequel les valeurs sont filtrées, par défaut null.
exemple : "color"

userQuery.conditionMarker: string | null
Marqueur de la condition de filtre par laquelle les valeurs sont filtrées, par défaut null.
exemple : "equals"

userQuery.langCode: string
Code de langue. Par défaut : "en_US".

userQuery.ids: string
Liste d'identifiants de produits séparés par des virgules — utilisée par getProductsByIds.
exemple : "1,2,3"

Par défaut, vous pouvez récupérer 10 objets. Cela est dû à la limite d'enregistrement dans les paramètres de permissions du module.
Pour que la pagination fonctionne correctement, vous devez configurer Permissions du module selon vos besoins dans la section correspondante.

Exemples

Exemple minimal

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

Exemple avec des attributs

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);

Utilisez des filtres pour trouver des produits spécifiques :

attributeMarker : L'identifiant textuel de l'attribut indexé par lequel les valeurs sont filtrées. conditionMarker : Le type de condition à appliquer à la valeur de l'attribut.

Marqueur	Signification	Exemple
eq	Égal	statusId = 1 (actif uniquement)
neq	Pas égal	role ≠ "Viewer"
in	Contient (un des)	role in ["Editor", "Manager"]
nin	Ne contient pas	email not in ["@temp.com"]
exs	Existe (a une valeur)	A un lastLogin
nexs	N'existe pas	Jamais connecté

conditionValue : La valeur à comparer.

Exemple de réponse

{
  "items": [
    {
      "id": 2957,
      "price": 150
    },
    {
      "id": 2954,
      "price": 51
    },
    {
      "id": 2955,
      "price": 0
    }
  ],
  "total": 3
}

Schéma de réponse

Schéma : IProductsInfo

total: number
Le nombre total de produits trouvés.
exemple : 100

items: IProductInfo[]
Un tableau d'objets d'information sur les produits.
exemple :

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

items.id: number
L'identifiant unique du produit.
exemple : 12345

items.price: number
Le prix du produit.
exemple : 150

---