Quản lý nhóm sản phẩmBộ sưu tập sản phẩm
Cập nhật bộ sưu tập
Cập nhật thông tin một bộ sưu tập sản phẩm
Endpoint
PUT /v1/productcollections/:id
Quyền:
product.manage
Path Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
id | int | Có | ID bộ sưu tập |
Request Body
Gửi đầy đủ các trường (tương tự API Tạo mới). Trường không gửi lên sẽ bị ghi đè bằng giá trị rỗng/0.
| 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 thao tác |
name | string | Có | Tên bộ sưu tập (duy nhất) |
type | int | Không | Loại (1: Auto, 3: Manual) |
description | string | Không | Mô tả |
external_id | string | Không | ID tham chiếu ngoài |
status | int | Không | 1 (Active), 3 (Disabled) |
avatar_file_id_list | array | Không | Danh sách ID ảnh đại diện |
product_id_list | array | Không | Danh sách ID sản phẩm (Manual) |
auto_rule | object | Không | Cấu hình rule tự động (Auto) |
seo_url | string | Không | URL SEO (duy nhất) |
seo_title | string | Không | Title SEO |
seo_meta_description | string | Không | Meta Description |
seo_meta_keyword | string | Không | Meta Keyword |
seo_graph_file_id | int | Không | Ảnh SEO Graph |
seo_canonical | string | Không | Canonical URL |
seo_options | object | Không | Tùy chọn SEO |
Ví dụ JSON
{
"company_id": 1,
"creator_id": 10,
"name": "Bộ sưu tập mùa đông 2024",
"type": 3,
"description": "Cập nhật mô tả mới",
"external_id": "",
"status": 1,
"avatar_file_id_list": [],
"product_id_list": [101, 102, 105, 200],
"auto_rule": {},
"seo_url": "bo-suu-tap-mua-dong-2024",
"seo_title": "Bộ sưu tập mùa đông",
"seo_meta_description": "",
"seo_meta_keyword": "",
"seo_graph_file_id": 0,
"seo_canonical": "",
"seo_options": {}
}Response Schema
HTTP 200 - OK
Trả về ProductCollection Object sau khi cập nhật.
Error Codes
Lỗi dữ liệu đầu vào (HTTP 422). Trả về mảng các mã lỗi trong trường error:
| Mã lỗi | Mô tả |
|---|---|
error_name_require | Tên bộ sưu tập không được để trống |
error_name_existed | Tên bộ sưu tập đã tồn tại |
error_seo_url_existed | SEO URL đã tồn tại |
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_not_found | Bộ sưu tập không tồn tại hoặc không thuộc công ty của bạn (HTTP 404) |
error_role_not_available | Không có quyền product.manage (HTTP 403) |
error_edit | Lỗi hệ thống khi lưu dữ liệu (HTTP 500) |