getProductsPriceByPageUrl

Cari informasi tentang produk dan harga untuk kategori yang dipilih.

Deskripsi

Metode ini mencari informasi tentang produk dan harga untuk kategori yang dipilih, berdasarkan parameter kueri yang diberikan (userQuery). Ini mengembalikan sebuah Promise yang menyelesaikan menjadi objek IProductsInfo.

Produk.getProductsPriceByPageUrl( url, langCode, userQuery );

Skema parameter

Skema

url: string
URL halaman
contoh: "23-laminat-floorwood-maxima"

langCode: string
Kode bahasa. Default: "en_US"
contoh: "en_US"

userQuery: IProductsQuery
Parameter kueri yang dapat diatur
contoh:

{
  "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
Parameter untuk paginasi. Default: 0.

userQuery.limit(required): number
Parameter untuk paginasi. Default: 30.

userQuery.sortOrder(required): string
Urutan pengurutan "DESC" | "ASC". Default: "DESC".

userQuery.sortKey(required): string
Bidang untuk pengurutan (default - null). Nilai yang mungkin: "id", "position", "title", "date", "price". Default: null.

userQuery.signPrice: string
Penanda penyimpanan pesanan untuk penetapan harga. Jika parameter ini diatur, harga akan tetap untuk waktu tertentu.

userQuery.templateMarker: string | null
Penanda template halaman produk, default null.
contoh: "template_12345"

userQuery.statusMarker: string | null
Penanda status halaman produk, default null.
contoh: "in_stock"

userQuery.conditionValue: string | null
Nilai yang dicari, default null.
contoh: "new"

userQuery.attributeMarker: string | null
Identifikasi teks dari atribut yang diindeks berdasarkan mana nilai difilter, default null.
contoh: "color"

userQuery.conditionMarker: string | null
Penanda kondisi filter berdasarkan mana nilai difilter, default null.
contoh: "equals"

userQuery.langCode: string
Kode bahasa. Default: "en_US".

userQuery.ids: string
Daftar id produk yang dipisahkan dengan koma — digunakan oleh getProductsByIds.
contoh: "1,2,3"

Secara default, Anda dapat mengambil 10 objek. Ini disebabkan oleh batasan catatan dalam pengaturan izin modul.
Untuk paginasi berfungsi dengan benar, Anda perlu mengonfigurasi Izin Modul sesuai kebutuhan Anda di bagian yang sesuai.

💲 signPrice mengunci harga yang dikembalikan untuk waktu terbatas — atur ke penanda penyimpanan pesanan Anda. Lihat Menetapkan harga (signPrice).

Contoh

Contoh minimal

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

Contoh dengan atribut

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

Gunakan filter untuk menemukan produk tertentu:

attributeMarker: Identifikasi teks dari atribut yang diindeks berdasarkan mana nilai difilter. conditionMarker: Jenis kondisi yang diterapkan pada nilai atribut.

Marker	Arti	Contoh
eq	Sama dengan	statusId = 1 (hanya aktif)
neq	Tidak sama dengan	role ≠ "Viewer"
in	Mengandung (salah satu)	role in ["Editor", "Manager"]
nin	Tidak mengandung	email not in ["@temp.com"]
exs	Ada (memiliki nilai)	Memiliki lastLogin
nexs	Tidak ada	Tidak pernah masuk

conditionValue: Nilai yang dibandingkan.

Contoh respons

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

Skema respons

Skema: IProductsInfo

total: number
Jumlah total produk yang ditemukan.
contoh: 100

items: IProductInfo[]
Array objek informasi produk.
contoh:

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

items.id: number
Identifikasi unik dari produk.
contoh: 12345

items.price: number
Harga produk.
contoh: 150

---