Quản lý nhóm sản phẩmThuộc tính
Tạo thuộc tính
Tạo mới một thuộc tính
Endpoint
POST /v1/attributes
Quyền:
product.manageattribute
Request Body
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
company_id | int | Có | ID công ty |
creator_id | int | Có | ID người tạo |
attribute_group_id | int | Có | ID nhóm thuộc tính cha |
name | string | Có | Tên thuộc tính (duy nhất trong nhóm) |
type | int | Có | Loại dữ liệu (1:Text, 3:Number, 5:Boolean, 7:Date, 9:Single Select, 11:Multi Select) |
status | int | Có | 1 (Kích hoạt), 3 (Vô hiệu hóa) |
description | string | Không | Mô tả |
file_id | int | Không | ID file ảnh/icon liên quan |
options | array | Không | Mảng các giá trị tùy chọn (cho type 9 hoặc 11). Ví dụ: ["Xanh", "Đỏ"]. Hệ thống lưu dưới dạng chuỗi nối bằng dấu phẩy |
allow_web_filter | int | Không | Cho phép lọc trên web (1: Có, 0: Không) |
default_show | int | Không | Mặc định hiển thị (1: Có, 0: Không) |
display_order | float | Không | Bị bỏ qua khi tạo: hệ thống tự gán bằng giá trị lớn nhất trong nhóm + 1 |
Ví dụ JSON
{
"company_id": 1,
"creator_id": 10,
"attribute_group_id": 10,
"name": "Màu sắc",
"type": 9,
"status": 1,
"description": "Thuộc tính màu sắc sản phẩm",
"file_id": 0,
"options": ["Xanh", "Đỏ", "Vàng"],
"allow_web_filter": 1,
"default_show": 1,
"display_order": 0
}Response Schema
HTTP 201 - Created
Trả về Attribute Object vừa tạo.
Lưu ý
Trường
display_order trong response của API tạo là giá trị bạn gửi lên; giá trị thực tế được hệ thống gán có thể xem qua API Chi tiết thuộc tính.Error Codes
Lỗi dữ liệu đầu vào. Trả về mảng các mã lỗi:
| Mã lỗi | Mô tả |
|---|---|
error_name_required | Tên thuộc tính không được để trống |
error_name_existed | Tên thuộc tính đã tồn tại trong nhóm này |
error_attribute_group_id_required | ID nhóm thuộc tính không được để trống |
error_attribute_group_id_invalid | ID nhóm thuộc tính không hợp lệ |
error_type_not_exist | Loại thuộc tính không hợp lệ |
error_status_not_exist | Trạng thái không hợp lệ |
error_file_id_not_valid | ID file không hợp lệ |
error_company_id_required | ID công ty không được để trống |
error_company_id_notfound | ID công ty không tìm thấy |
error_user1_id_required | ID người tạo không được để trống |
error_user_id_notfound | ID người tạo không tìm thấy |
error_role_not_available | Tài khoản không có quyền product.manageattribute (HTTP 403) |