getProductsPriceByPageUrl

ابحث عن معلومات حول المنتجات والأسعار لفئة محددة.

الوصف

تبحث هذه الطريقة عن معلومات حول المنتجات والأسعار للفئة المحددة، بناءً على معلمات الاستعلام المقدمة (userQuery). تُرجع Promise التي تحل إلى كائن IProductsInfo.

Products.getProductsPriceByPageUrl( url, langCode, userQuery );

مخطط المعلمات

المخطط

url: string
رابط الصفحة
مثال: "23-laminat-floorwood-maxima"

langCode: string
رمز اللغة. الافتراضي: "en_US"
مثال: "en_US"

userQuery: IProductsPriceQuery
مجموعة معلمات الاستعلام الاختيارية
مثال:

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

userQuery.offset: number
معلمة للتصفح. الافتراضي: 0.

userQuery.limit: number
معلمة للتصفح. الافتراضي: 30.

userQuery.sortOrder: string
ترتيب الفرز "DESC" | "ASC". الافتراضي: "DESC".

userQuery.signPrice: string
علامة تخزين الطلب لتثبيت السعر.

userQuery.statusMarker: string | null
علامة حالة صفحة المنتج، الافتراضي null.
مثال: "in_stock"

بشكل افتراضي، يمكنك استرداد 10 كائنات. وذلك بسبب حد السجلات في إعدادات أذونات الوحدة.
لعمل التصفح بشكل صحيح، تحتاج إلى تكوين أذونات الوحدة وفقًا لاحتياجاتك في القسم المقابل.

💲 signPrice يقفل السعر المعاد لفترة محدودة — قم بتعيينه إلى علامة تخزين الطلب الخاصة بك. انظر تثبيت السعر (signPrice).

أمثلة

مثال بسيط

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

مثال مع السمات

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

استخدم الفلاتر للعثور على منتجات محددة:

attributeMarker: المعرف النصي للسمة المفهرسة التي يتم تصفية القيم بناءً عليها. conditionMarker: نوع الشرط الذي سيتم تطبيقه على قيمة السمة.

العلامة	المعنى	المثال
eq	يساوي	statusId = 1 (نشط فقط)
neq	لا يساوي	role ≠ "Viewer"
in	يحتوي على (واحد من)	role in ["Editor", "Manager"]
nin	لا يحتوي على	email not in ["@temp.com"]
exs	موجود (له قيمة)	لديه lastLogin
nexs	غير موجود	لم يسجل الدخول أبدًا
pat	يتطابق مع النمط	المعرف يتطابق مع "man"
same	يتطابق مع القيمة بالضبط	المعرف هو بالضبط "admin1"
same_part	يتطابق مع جزء من القيمة بالضبط	جزء من المعرف هو بالضبط "adm"

conditionValue: القيمة التي سيتم المقارنة بها.

مثال على الاستجابة

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

مخطط الاستجابة

المخطط: IProductsInfo

total: number
إجمالي عدد المنتجات التي تم العثور عليها.
مثال: 100

items: IProductInfo[]
مصفوفة من كائنات معلومات المنتج.
مثال:

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

items.id: number
المعرف الفريد للمنتج.
مثال: 12345

items.price: number
سعر المنتج.
مثال: 150

items.signedPrice: string
السعر الموقّع (الثابت) للمنتج، يُعاد عندما يتم تعيين signPrice.
انظر: سعر المنتج الثابت
مثال: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

---