Skip to main content Link Search Menu Expand Document (external link)

Product API

Product API dùng để lấy thông tin sản phẩm

GET /products/{product-alias}.js

Lấy thông tin sản phẩm sử dụng alias

Dữ liệu trả về

Trả về json có trường product chứa thông tin sản phẩm. ví dụ:

{
  "product": {
    "id": 11365744,
    "name": "bé trai",
    "alias": "be-trai",
    "vendor": null,
    "product_type": null,
    "price": 20000,
    "price_max": 20000,
    "price_min": 20000,
    "price_varies": false,
    "compare_at_price_max": 0,
    "compare_at_price_min": 0,
    "compare_at_price_varies": false,
    "tags": [],
    "summary": null,
    "content": "",
    "featured_image": "https://bizweb.dktcdn.net/105/299/218/products/ddi4os8-7041e05c-2df9-4f27-99fa-d5728f090988.png?v=1653540406460",
    "images": [
      "https://bizweb.dktcdn.net/105/299/218/products/ddi4os8-7041e05c-2df9-4f27-99fa-d5728f090988.png?v=1653540406460",
    ],
    "options": [
      {
        "name": "Title"
      }
    ],
    "variants": [
      {
        "id": 17581931,
        "barcode": null,
        "sku": null,
        "unit": null,
        "price": 20000,
        "compare_at_price": null,
        "options": ["Default Title"],
        "option1": "Default Title",
        "option2": null,
        "option3": null,
        "title": "Default Title",
        "inventory_management": "",
        "inventory_policy": "deny",
        "inventory_quantity": 1,
        "weight": 0,
        "weight_unit": "g",
        "featured_image": {
          "src": "https://bizweb.dktcdn.net/105/299/218/products/ddi4os8-7041e05c-2df9-4f27-99fa-d5728f090988.png?v=1653540406460"
        },
        "available": true,
        "url": "/be-trai?variantId=17581931"
      }
    ],
    "available": true,
    "url": "/be-trai"
  }
}

Các trường nằm bên ngoài trường product chỉ để đảm bảo tương thích với giao diện cũ

Đối tượng

Product

Thông tin sản phẩm

Thuộc tính
available (boolean)

Trả về true nếu ít nhất một phiên bản còn hàng, ngược lại trả về false

compare_at_price (number)

Giá trị compare_at_price nhỏ nhất của tất cả các phiên bản trong sản phẩm

compare_at_price_max (number)

Giá trị compare_at_price lớn nhất của tất cả các phiên bản trong sản phẩm

compare_at_price_min (number)

Giá trị compare_at_price nhỏ nhất của tất cả các phiên bản trong sản phẩm. Giá trị này tương tự như product.compare_at_price

compare_at_price_varies (boolean)

Trả về true nếu giá trị compare_at_price của sản phẩm biến đổi, ngược lại trả về false

content (string)

Mô tả của sản phẩm

Ảnh đại diện của sản phẩm

id (number)

Id của sản phẩm

images (mảng string)

Danh sách ảnh của sản phẩm

name (string)

Tên của sản phẩm

options (mảng product_option)

Danh sách tùy chọn của sản phẩm

price (number)

Giá trị price nhỏ nhất của tất cả các phiên bản trong sản phẩm

price_max (number)

Giá trị price lớn nhất của tất cả các phiên bản trong sản phẩm

price_min (number)

Giá trị price nhỏ nhất của tất cả các phiên bản trong sản phẩm. Giá trị này tương tự như product.price

price_varies (boolean)

Trả về true nếu giá trị price của sản phẩm biến đổi, ngược lại trả về false

product_type (string)

Loại sản phẩm

summary (string)

Mô tả ngắn của sản phẩm

tags (mảng string)

Danh sách tag của sản phẩm

url (string)

Đường dẫn tới sản phẩm

variants (mảng variant)

Danh sách phiên bản của sản phẩm

vendor (string)

Tên nhà cung cấp

Product_option

Tùy chọn của sản phẩm

Thuộc tính
name (string)

Tên của tùy chọn

Variant

Thông tin phiên bản của sản phẩm

Thuộc tính
barcode (string)

Mã barcode của phiên bản

compare_at_price (number)

Giá so sánh của phiên bản

Ảnh đại diện của phiên bản

id (number)

ID của phiên bản

inventory_management (string)

Thông tin dịch vụ quản lý kho của variant

inventory_policy (string)

Chính sách quản lý kho khi phiên bản không còn hàng

inventory_quantity (number)

Số lượng tồn kho của phiên bản

option1 (string)

Giá trị của phiên bản cho tùy chọn thứ 1 của sản phẩm

option2 (string)

Giá trị của phiên bản cho tùy chọn thứ 2 của sản phẩm

option3 (string)

Giá trị của phiên bản cho tùy chọn thứ 3 của sản phẩm

options (mảng string)

Danh sách các giá trị của phiên bản cho các tùy chọn của sản phẩm

price (number)

Giá của phiên bản

sku (string)

SKU của phiên bản

title (string)

Tiêu đề của phiên bản

unit (string)

Đơn vị tính

url (string)

Đường dẫn của phiên bản. Có dạng /[product-alias]?variantId=[variant-id]

weight (number)

Khối lượng của phiên bản tính theo grams

weight_unit (string)

Đơn vị khối lượng của phiên bản được cấu hình