getProductsPriceByPageUrl

Tìm kiếm thông tin về sản phẩm và giá cho danh mục đã chọn.

Mô tả

Phương thức này tìm kiếm thông tin về sản phẩm và giá cho danh mục đã chọn, dựa trên các tham số truy vấn được cung cấp (userQuery). Nó trả về một Promise mà khi hoàn thành sẽ trả về một đối tượng IProductsInfo.

Products.getProductsPriceByPageUrl( url, langCode, userQuery );

Sơ đồ tham số

Sơ đồ

url: string
URL trang
ví dụ: "23-laminat-floorwood-maxima"

langCode: string
Mã ngôn ngữ. Mặc định: "en_US"
ví dụ: "en_US"

userQuery: IProductsPriceQuery
Tham số truy vấn tùy chọn
ví dụ:

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

userQuery.offset: number
Tham số cho phân trang. Mặc định: 0.

userQuery.limit: number
Tham số cho phân trang. Mặc định: 30.

userQuery.sortOrder: string
Thứ tự sắp xếp "DESC" | "ASC". Mặc định: "DESC".

userQuery.signPrice: string
Dấu hiệu lưu trữ đơn hàng cho việc cố định giá.

userQuery.statusMarker: string | null
Dấu hiệu trạng thái trang sản phẩm, mặc định là null.
ví dụ: "in_stock"

Mặc định, bạn có thể lấy 10 đối tượng. Điều này là do giới hạn bản ghi trong cài đặt quyền của mô-đun.
Để phân trang hoạt động chính xác, bạn cần cấu hình Quyền mô-đun theo nhu cầu của bạn trong phần tương ứng.

💲 signPrice khóa giá trả về trong một khoảng thời gian giới hạn — đặt nó thành dấu hiệu lưu trữ đơn hàng của bạn. Xem Cố định giá (signPrice).

Ví dụ

Ví dụ tối thiểu

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

Ví dụ với các thuộc tính

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

Sử dụng bộ lọc để tìm các sản phẩm cụ thể:

attributeMarker: Định danh văn bản của thuộc tính đã được lập chỉ mục mà theo đó các giá trị được lọc. conditionMarker: Loại điều kiện áp dụng cho giá trị thuộc tính.

Marker	Ý nghĩa	Ví dụ
eq	Bằng	statusId = 1 (chỉ hoạt động)
neq	Không bằng	role ≠ "Viewer"
in	Chứa (một trong số)	role in ["Editor", "Manager"]
nin	Không chứa	email not in ["@temp.com"]
exs	Tồn tại (có giá trị)	Có lastLogin
nexs	Không tồn tại	Chưa bao giờ đăng nhập
pat	Khớp với mẫu	identifier khớp với "man"
same	Khớp với giá trị chính xác	identifier chính xác là "admin1"
same_part	Khớp với một phần của giá trị chính xác	phần của identifier chính xác là "adm"

conditionValue: Giá trị để so sánh.

Ví dụ phản hồi

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

Sơ đồ phản hồi

Sơ đồ: IProductsInfo

total: number
Tổng số sản phẩm được tìm thấy.
ví dụ: 100

items: IProductInfo[]
Mảng các đối tượng thông tin sản phẩm.
ví dụ:

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

items.id: number
Định danh duy nhất của sản phẩm.
ví dụ: 12345

items.price: number
Giá của sản phẩm.
ví dụ: 150

items.signedPrice: string
Giá đã ký (cố định) của sản phẩm, trả về khi signPrice được thiết lập.
xem: Giá sản phẩm cố định
ví dụ: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

---