Lewati ke konten utama

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: IProductsPriceQuery
Parameter kueri yang dapat disetel
contoh:

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

userQuery.offset: number
Parameter untuk paginasi. Default: 0.

userQuery.limit: number
Parameter untuk paginasi. Default: 30.

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

userQuery.signPrice: string
Penanda penyimpanan pesanan untuk penetapan harga.

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

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: Pengidentifikasi teks dari atribut yang diindeks di mana nilai-nilai difilter. conditionMarker: Jenis kondisi yang diterapkan pada nilai atribut.

MarkerArtiContoh
eqSamastatusId = 1 (hanya aktif)
neqTidak samarole ≠ "Viewer"
inMengandung (salah satu)role in ["Editor", "Manager"]
ninTidak mengandungemail tidak dalam ["@temp.com"]
exsAda (memiliki nilai)Memiliki lastLogin
nexsTidak adaTidak pernah masuk
patCocok dengan polapengidentifikasi cocok dengan "man"
sameCocok dengan nilai persispengidentifikasi persis "admin1"
same_partCocok dengan sebagian nilai persissebagian pengidentifikasi persis "adm"

conditionValue: Nilai untuk 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
Pengidentifikasi unik produk.
contoh: 12345

items.price: number
Harga produk.
contoh: 150

items.signedPrice: string
Harga yang ditandatangani (tetap) dari produk, dikembalikan ketika signPrice disetel.
lihat: Harga produk tetap
contoh: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."