Product API Docs

API lấy danh sách sản phẩm cho khách bán hàng.

Trang này chỉ mô tả các field website EmpireX đang dùng để hiển thị card sản phẩm, trang chi tiết, bộ lọc, giỏ hàng và mua ngay. Không trả thêm dữ liệu nội bộ.

1. Bắt đầu nhanh

Gọi API danh sách để lấy sản phẩm đang bán, sau đó render card giống trang bán hàng: ảnh, tên, giá, giảm giá, trạng thái còn/hết hàng.

GET /api/accounts

GET /api/services

GET /api/products/{id-or-slug}

2. API danh sách sản phẩm

GET /api/accounts?page=1&limit=20&sort=price&order=asc&locale=vi&category_id=cat-ai-tools

Query	Ý nghĩa	Ví dụ
category_id	Lọc theo danh mục đang có trên website	cat-ai-tools
sort	Sắp xếp: view_count, created_at, price	price
order	Chiều sắp xếp: asc hoặc desc	asc
page	Trang hiện tại	1
limit	Số sản phẩm mỗi trang, website đang dùng 20	20
locale	Ngôn ngữ dữ liệu trả về	vi

{
  "success": true,
  "data": {
    "items": [
      {
        "id": "prod_chatgpt_plus",
        "slug": "chatgpt-plus-nang-cap-chinh-chu",
        "type": "account",
        "name_vi": "ChatGPT Plus - Nâng cấp chính chủ",
        "name_en": "ChatGPT Plus - Official Upgrade",
        "thumbnail": "https://example.com/images/chatgpt-plus.webp",
        "inventory_status": "in-stock",
        "categories": [
          {
            "category": {
              "id": "cat-ai-tools",
              "name_vi": "AI Tools",
              "name_en": "AI Tools",
              "slug": "ai-tools"
            }
          }
        ],
        "variants": [
          {
            "id": "var_1m",
            "name_vi": "Gói 1 tháng",
            "name_en": "1 Month",
            "price_vnd": 135000,
            "price_usd": 5.5,
            "original_price_vnd": 550000,
            "original_price_usd": 22,
            "stock": true,
            "is_default": true,
            "sku": "CGPT-PLUS-1M"
          }
        ]
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 120,
      "totalPages": 6
    }
  }
}

3. API chi tiết sản phẩm

Dùng khi khách bấm vào một sản phẩm để xem đầy đủ mô tả, tính năng, bảo hành và cách giao hàng.

GET /api/products/chatgpt-plus-nang-cap-chinh-chu

{
  "success": true,
  "data": {
    "id": "prod_chatgpt_plus",
    "slug": "chatgpt-plus-nang-cap-chinh-chu",
    "type": "account",
    "name_vi": "ChatGPT Plus - Nâng cấp chính chủ",
    "name_en": "ChatGPT Plus - Official Upgrade",
    "description_vi": "Mô tả chi tiết đang hiển thị ở trang sản phẩm.",
    "description_en": "Product detail description shown on the product page.",
    "thumbnail": "https://example.com/images/chatgpt-plus.webp",
    "inventory_status": "in-stock",
    "delivery_type_vi": "Giao tài khoản thủ công",
    "delivery_type_en": "Manual account delivery",
    "vietnam_only": false,
    "variant_layout": "default",
    "images": [
      {
        "image_url": "https://example.com/images/chatgpt-plus-1.webp",
        "locale": "vi",
        "order_index": 1
      }
    ],
    "categories": [
      {
        "category": {
          "id": "cat-ai-tools",
          "name_vi": "AI Tools",
          "name_en": "AI Tools",
          "slug": "ai-tools"
        }
      }
    ],
    "variants": [
      {
        "id": "var_1m",
        "name_vi": "Gói 1 tháng",
        "name_en": "1 Month",
        "sku": "CGPT-PLUS-1M",
        "price_vnd": 135000,
        "price_usd": 5.5,
        "original_price_vnd": 550000,
        "original_price_usd": 22,
        "stock": true,
        "is_default": true,
        "warranty_duration": 1,
        "warranty_unit": "month",
        "image": "https://example.com/images/chatgpt-plus-variant.webp",
        "images": []
      }
    ]
  }
}

4. Giải thích dữ liệu product

id

Mã sản phẩm dùng để mở chi tiết, thêm giỏ hàng, mua ngay.

slug

Đường dẫn sản phẩm, ví dụ /vi/accounts/chatgpt-plus.

type

Loại đang dùng để tạo link: account hoặc service.

name_vi / name_en

Tên sản phẩm đang hiển thị theo ngôn ngữ website.

thumbnail

Ảnh card sản phẩm trên trang danh sách.

inventory_status

Trạng thái tồn kho trên card/detail.

categories

Danh mục để lọc và hiển thị nhóm sản phẩm.

variants

Các gói/biến thể để hiển thị giá, giá gốc, SKU, tồn kho.

description_vi / description_en

Mô tả chi tiết đang hiện trong trang sản phẩm.

images

Ảnh gallery trong trang chi tiết sản phẩm.

delivery_type_vi / delivery_type_en

Thông tin giao hàng đang hiện trong khối tính năng.

warranty_duration / warranty_unit

Thông tin bảo hành đang hiện theo biến thể.

vietnam_only

Nếu true, website hiện cảnh báo chỉ dành cho Việt Nam trước khi mua.

variant_layout

Cách hiển thị biến thể: default, matrix_2d, matrix_3d.

5. Trạng thái tồn kho

in-stock

Còn hàng, cho phép mua hoặc thêm giỏ hàng.

low-stock

Sắp hết hàng, hiển thị badge cảnh báo.

out-of-stock

Hết hàng, vô hiệu hóa nút mua/thêm giỏ.

price = 0

Hiển thị “Liên hệ báo giá”, không hiện nút mua thường.