Quản lý sản phẩm (PIM)Danh mục sản phẩm

Lấy danh sách theo IDs

Lấy thông tin nhiều danh mục cùng lúc dựa trên danh sách ID.

Endpoint

GET /site/productcategories/ids

Headers

KeyValueBắt buộcMô tả
SiteTenantId{tenant_id}CóID của công ty/tenant.

Workflow & Logic

API này thường dùng cho các Widget hiển thị danh sách danh mục chỉ định (Featured Categories) hoặc lấy thông tin bổ sung cho một danh sách ID có sẵn.

Quy trình xử lý (Internal Processing)

  1. Nhận diện danh sách ID:

    • Lấy danh sách ID từ query param ids (tối đa 100 ID, bỏ qua ID trùng hoặc không hợp lệ).
    • Nếu ids rỗng: trả về total = 0 và items rỗng.
  2. Truy vấn Batch (Batch Query):

    • Lấy các danh mục thuộc shop hiện tại có ID nằm trong danh sách (không lọc theo trạng thái).
    • Sắp xếp kết quả theo id ASC (mặc định).
  3. Trả về:

    • Danh sách các đối tượng danh mục tương ứng.

Query Parameters

TênKiểuBắt buộcMô tả
idsstringCóDanh sách ID phân cách bởi dấu phẩy (ví dụ: 1,2,3).

Response Schema

HTTP 200 - JSON Object

{
  "total": 2,
  "items": [
    {
      "id": 1,
      "name": "Danh mục 1",
      // ...
    },
    {
      "id": 2,
      "name": "Danh mục 2",
      // ...
    }
  ]
}

Xem Product Category Object Schema

On this page