Skip to content

Endpoint Files ​

Trang này liệt kê 2 endpoint tệp trong file.api.ts: tải một file lên và xóa một file. Frontend hiện dùng chúng cho logo công ty. Hợp đồng đầy đủ nằm ở tài liệu backend.

Vì sao tải file riêng khỏi lưu công ty ​

Form công ty lưu tên file logo, không lưu cả file. Người dùng chọn ảnh, frontend tải lên ngay để lấy tên file, rồi tên đó được gửi cùng form công ty. Nếu người dùng đổi ảnh hoặc hủy, frontend xóa file đã tải để không để lại file thừa.

Bảng endpoint ​

Hook RTK QueryMethod và pathTham số frontend gửiCache tagNơi dùng
useUploadFileMutationPOST /files/uploadFormData chứa file; thư mục đích đặt ở header folder_typeKhônghooks/use-file.ts (handleUpload)
useDeleteFileMutationDELETE /files/removeBody { fileName, folderType }Khônghooks/use-file.ts (handleDelete)

useFileOperations bọc hai hook: handleUpload trả fileName và hiện toast, còn handleDelete xóa không chờ kết quả. Hiện chỉ có thư mục company được truyền (từ logo-upload.tsx và company-dialog.tsx).

Header folder_type được đặt trong cấu hình request; Content-Type để Axios tự đặt theo FormData.

Đối chiếu với backend ​

Cả hai route có trong files.controller.ts. Theo controller: upload đọc thư mục từ header folder_type, không khai báo giới hạn vai trò; remove chỉ cho SUPER ADMIN và HR.

Logo công ty được kiểm tra ở phía frontend (logo-upload.tsx): chỉ nhận JPEG, PNG, GIF, WEBP và tối đa 2 MB. Chưa đối chiếu giới hạn tương ứng ở backend.

Dữ liệu ​

Tải lên trả { fileName }; xóa trả { deleted }.

Source code liên quan ​

Hợp đồng đầy đủ: API Files của backend và controller.

Đọc tiếp: Endpoint Companies, Model Company, Quy ước API.

Tài liệu kỹ thuật xây dựng theo chuẩn Documentation as Code