Thêm sản phẩm vào yêu thích

EndpointCopy Anchor Link

POST /site/customerwishlists

HeadersCopy Anchor Link

Workflow & LogicCopy Anchor Link

API này dùng để thêm một sản phẩm vào danh sách yêu thích (wishlist) của khách hàng đang đăng nhập. Hệ thống sẽ tự động gắn company_id và customer_id từ session, đảm bảo mỗi sản phẩm chỉ được thêm một lần cho mỗi khách hàng.

Quy trình xử lýCopy Anchor Link

1. Xác thực Session: Kiểm tra JWT token và xác định company_id + customer_id từ token. Yêu cầu đăng nhập bắt buộc.

2. Validate dữ liệu:

   • product_id — bắt buộc, phải là ID sản phẩm tồn tại và thuộc shop hiện tại.
   • from — bắt buộc, phải nằm trong danh sách nguồn hợp lệ (xem bảng From).
   • Kiểm tra trùng: Nếu sản phẩm đã nằm trong wishlist của khách hàng, trả lỗi error_product_id_existed.

3. Tạo bản ghi wishlist: Gán company_id, customer_id từ session; product_id, from, ip_address từ request body.

4. Trả kết quả: Trả về đối tượng wishlist vừa tạo với HTTP 201.

Request BodyCopy Anchor Link

Content-Type: application/json

{
  "product_id": 789,
  "from": 1,
  "ip_address": "192.168.1.1"
}

Response SchemaCopy Anchor Link

HTTP 201 - Created (Thành công)Copy Anchor Link

Trả về đối tượng Customer Wishlist Object vừa được tạo.

{
  "id": 102,
  "company_id": 123,
  "creator_id": 456,
  "product_id": 789,
  "from": 1,
  "ip_address": "192.168.1.1",
  "date_created": 1740300000,
  "date_modified": 0
}

HTTP 401 - UnauthorizedCopy Anchor Link

Nếu không gửi token (error_customer_login_required), token không hợp lệ/hết hạn/đã đăng xuất (error_jwt_hash_not_found, error_jwt_expired, error_jwt_blacklisted...) hoặc là token của khách hàng thuộc shop khác (error_customer_company_mismatch). Xem Giới thiệu.

HTTP 422 - Validation ErrorCopy Anchor Link

Trả về khi dữ liệu đầu vào không hợp lệ.

HTTP 500 - Internal Server ErrorCopy Anchor Link

Lỗi hệ thống khi không thể tạo bản ghi wishlist (error_add).