Quản lý nhóm sản phẩmNhóm thuộc tính
Tạo nhóm thuộc tính
Tạo mới một nhóm thuộc tính
Endpoint
POST /v1/attributegroups
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_category_id | int | Có | ID bộ thuộc tính cha |
name | string | Có | Tên nhóm thuộc tính (duy nhất trong toàn công ty) |
description | string | Không | Mô tả |
status | int | Có | 1 (Kích hoạt), 3 (Vô hiệu hóa). Hệ thống không kiểm tra giá trị, hãy gửi đúng 1 hoặc 3 |
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 bộ thuộc tính + 1 |
Ví dụ JSON
{
"company_id": 1,
"creator_id": 10,
"attribute_category_id": 1,
"name": "Kích thước & Trọng lượng",
"description": "Nhóm chứa các thuộc tính kích thước",
"status": 1,
"display_order": 2
}Response Schema
HTTP 201 - Created
Trả về AttributeGroup 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 nhóm 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 nhóm thuộc tính không được để trống |
error_name_existed | Tên nhóm thuộc tính đã tồn tại |
error_attribute_category_id_required | ID bộ thuộc tính không được để trống |
error_attribute_category_id_invalid | ID bộ thuộc tính không hợp lệ hoặc không tìm thấy |
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) |