เอกสาร Product API
เอกสารอ้างอิงนี้อธิบายฟิลด์ JSON สาธารณะแบบอ่านอย่างเดียวที่ใช้ขับเคลื่อนการ์ดสินค้า หน้ารายละเอียด ตัวกรองหมวดหมู่ ป้ายสถานะสต็อก และตัวเลือกราคา VND/USD ของ EmpireX โดยไม่มีการเปิดเผยข้อมูลส่วนบุคคลใดๆ
ดึงรายการสินค้าที่เปิดขายผ่าน list endpoint เพื่อแสดงการ์ดหน้าร้านพร้อมรูปตัวอย่าง ชื่อตามภาษา ราคา VND/USD ส่วนลด และสถานะความพร้อมจำหน่าย
| พารามิเตอร์ | คำอธิบาย | ตัวอย่าง |
|---|---|---|
| category_id | กรองรายการสินค้าตามรหัสหมวดหมู่หน้าร้าน | cat-ai-tools |
| sort | ฟิลด์จัดเรียง: view_count, created_at หรือ price | price |
| order | ทิศทางการเรียงลำดับ: asc หรือ desc | asc |
| page | หมายเลขหน้า (เริ่มนับจาก 1) | 1 |
| limit | จำนวนรายการต่อหน้า (ค่าเริ่มต้นหน้าร้านคือ 20) | 20 |
| locale | รหัสภาษาของข้อมูลผลลัพธ์ที่ต้องการ | th |
{
"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://empirex.org/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
}
}
}ใช้ endpoint นี้เมื่อเปิดดูหน้าสินค้ารายตัวเพื่อโหลดคำอธิบายฉบับเต็ม แกลเลอรีรูปภาพ ระยะเวลารับประกัน และเงื่อนไขการจัดส่ง
{
"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://empirex.org/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://empirex.org/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://empirex.org/images/chatgpt-plus-variant.webp",
"images": []
}
]
}
}idรหัสอ้างอิงสินค้าที่ไม่ซ้ำกัน ใช้สำหรับค้นหารายละเอียด ตะกร้าสินค้า และการชำระเงิน
slugสลัก URL ของสินค้าที่อ่านเข้าใจง่าย เช่น /en/accounts/chatgpt-plus
typeประเภทเส้นทางในแคตตาล็อก: account หรือ service
name_vi / name_enชื่อสินค้าที่แปลตามแต่ละภาษา
thumbnailรูปภาพหลักของการ์ดที่แสดงบนหน้ารวมสินค้า
inventory_statusตัวบ่งชี้สถานะสต็อกระดับบนสุดที่แสดงบนการ์ดและหน้ารายละเอียด
categoriesหมวดหมู่ที่กำหนดไว้สำหรับกรองและจัดกลุ่มหน้าร้าน
variantsระดับแพ็กเกจหรือตัวเลือกพร้อมราคา VND & USD ราคาเต็ม รหัส SKU และจำนวนคงเหลือ
description_vi / description_enคำอธิบายสินค้าแบบละเอียดแยกตามภาษาสำหรับแสดงในหน้ารายละเอียด
imagesลำดับรูปภาพแกลเลอรีของสินค้าในหน้ารายละเอียด
delivery_type_vi / delivery_type_enรูปแบบการจัดส่งตามภาษาที่แสดงในส่วนจุดเด่นสินค้า
warranty_duration / warranty_unitระยะเวลาและหน่วยการรับประกันแยกตามแต่ละตัวเลือกสินค้า
vietnam_onlyเมื่อเป็น true หมายถึงจำกัดการเปิดใช้งานหรือการใช้งานเฉพาะในเวียดนามเท่านั้น
variant_layoutโหมดการแสดงผลปุ่มเลือกตัวเลือก: default, matrix_2d หรือ matrix_3d
in-stockพร้อมให้เพิ่มลงตะกร้าและชำระเงินได้ทันที
low-stockสินค้าคงเหลือมีจำกัด แสดงป้ายแจ้งเตือนสินค้าใกล้หมด
out-of-stockสินค้าหมดชั่วคราว ปิดการกดสั่งซื้อ
price = 0สินค้าต้องขอใบเสนอราคาเฉพาะ ("ติดต่อขอใบเสนอราคา") ซ่อนปุ่มซื้อปกติ