Admin Products API
Tài liệu chi tiết về API quản lý sản phẩm dành cho Admin (Merchant). Hệ thống hỗ trợ CRUD sản phẩm, thiết lập giá bán và các tính năng import bất đồng bộ qua Excel.
HTTP Endpoints
| Phương thức | Đường dẫn | Mô tả |
|---|---|---|
POST | /product/create_product | Tạo mới sản phẩm |
GET | /product/get_product | Lấy danh sách sản phẩm |
PUT | /product/update_product | Cập nhật thông tin sản phẩm |
DELETE | /product/delete_product | Xóa sản phẩm |
POST | /product/import_product | Import danh sách sản phẩm từ file Excel |
GET | /product/check_import | Kiểm tra trạng thái tiến trình import |
Schema Reference
Product Object Schema
Dưới đây là chi tiết các thuộc tính chính trong đối tượng Product:
| Thuộc tính | Kiểu dữ liệu | Yêu cầu | Mô tả |
|---|---|---|---|
name | string | Bắt buộc | Tên sản phẩm. |
product_code | string | Tùy chọn | Mã SKU/mã sản phẩm định danh. |
price | number | Bắt buộc | Giá bán lẻ của sản phẩm. |
cost | number | Tùy chọn | Giá vốn nhập hàng. |
category_id | string | Tùy chọn | ID danh mục của sản phẩm. |
description | string | Tùy chọn | Mô tả chi tiết sản phẩm. |
images | array | Tùy chọn | Danh sách hình ảnh của sản phẩm. |
API Methods
Tạo sản phẩm
POST /product/create_product
Token-Business: <business_access_token>
Content-Type: application/json
Request Body Example
{
"name": "Áo thun Polo Nam",
"product_code": "AT-POLO-01",
"price": 250000,
"cost": 120000,
"category_id": "cat_1294812",
"description": "Chất liệu cotton thoáng mát, thấm hút mồ hôi tốt."
}