انتقل إلى المحتوى الرئيسي

getAllDiscounts

الحصول على جميع كائنات الخصم.

الوصف

تسترجع هذه الطريقة جميع كائنات الخصم. ستضيف الطريقة اللغة الافتراضية إلى جسم الطلب. إذا كنت ترغب في تغيير اللغة، فقط مررها كأول وسيط. ترجع وعدًا (Promise) يتم حله إلى مصفوفة من كائنات IDiscountEntity.

Discounts.getAllDiscounts(

langCode, offset, limit, type

);

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

المخطط

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

offset: number
وسيط اختياري للتصفح. الافتراضي: 0
مثال: 0

limit: number
وسيط اختياري للتصفح. الافتراضي: 30
مثال: 30

type: string
وسيط اختياري لتصفية الخصومات حسب النوع

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

أمثلة

مثال بسيط

const response = await Discounts.getAllDiscounts();

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

const response = await Discounts.getAllDiscounts('en_US', 0, 30);

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

{
"items": [
{
"id": 1,
"type": "DISCOUNT",
"attributeSetId": 31,
"conditionLogic": "AND",
"discountValue": {
"value": 10,
"maxAmount": 5,
"discountType": "FIXED_AMOUNT",
"applicability": "TO_PRODUCT"
},
"exclusions": null,
"gifts": null,
"giftsReplaceCartItems": false,
"userGroups": null,
"userExclusions": null,
"localizeInfos": {
"title": "Example discount"
},
"version": 0,
"identifier": "example_discount",
"startDate": "2026-03-14T14:55:19.928Z",
"endDate": "2026-07-31T13:55:24.647Z",
"attributeValues": {
"example_discount": {
"type": "string",
"value": "test value",
"isIcon": false,
"position": 0,
"additionalFields": {},
"isProductPreview": false
}
},
"conditions": [],
"position": 1
}
],
"total": 1
}

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

المخطط: IDiscountEntity[]

items: IDiscountsEntity[]
مصفوفة من كائنات الخصم.

items.id: number
المعرف الفريد للخصم.

items.attributeSetId: number
معرف الخصم.

items.localizeInfos: object
اسم الخصم.

items.version: number
إصدار الخصم.

items.identifier: string
معرف الخصم.

items.type: string
نوع الخصم.

items.startDate: string
تاريخ بدء الخصم.

items.endDate: string
تاريخ انتهاء الخصم.

items.discountValue: Record<string, unknown>
قيمة الخصم.

items.conditionLogic: string
منطق الخصم. القيم الممكنة هي "AND" | "OR".

items.conditions: IDiscountCondition[]
شروط الخصم.

conditions.type: string
نوع شرط الخصم.

conditions.value: string
القيمة المرتبطة بشرط الخصم.

items.exclusions: object
استثناءات الخصم.

items.gifts: object
الهدايا المرتبطة بالخصم.

items.giftsReplaceCartItems: boolean
ما إذا كانت الهدايا تحل محل عناصر السلة.

items.userGroups: object
مجموعات المستخدمين المرتبطة بالخصم.

items.userExclusions: object
استثناءات المستخدمين المرتبطة بالخصم.

items.attributeValues: object
قيم السمات المرتبطة بالخصم.

items.attributeSetIdentifier: string
معرف مجموعة السمات.

total: number
إجمالي عدد الخصومات.