Quản lý File
Giới hạn upload
Dung lượng tối đa mỗi file, định dạng được nhận và hạn mức dung lượng đang áp dụng cho công ty
Endpoint
GET /v1/filehelpers/stats?only=limits
Trả về giới hạn upload đang áp dụng cho công ty (theo gói dịch vụ). Dùng để kiểm tra file phía client trước khi gọi Upload File; API upload vẫn luôn kiểm tra lại.
Query Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
company_id | int | Có | ID công ty của phiên đăng nhập |
only | string | Không | limits: chỉ trả giới hạn (nhanh). Bỏ trống: kèm thống kê dung lượng theo loại file (size_by_type, count_file_by_type) |
Response Schema
| Trường | Kiểu | Mô tả |
|---|---|---|
company_id | int | ID công ty |
quota | int | Hạn mức tổng dung lượng file của công ty (byte) |
file_max_size | int | Dung lượng tối đa một file (byte), lớn nhất trong các nhóm |
file_max_size_mb | int | Như trên, đơn vị MB |
file_max_size_by_category | object | Dung lượng tối đa một file (byte) theo nhóm: image, video, audio, document, archive |
site_file_max_size | int | Dung lượng tối đa một file khách hàng upload từ website bán hàng (byte) |
allow_file_types | string[] | Phần mở rộng được nhận (chữ hoa) |
site_allow_file_types | string[] | Phần mở rộng khách hàng được upload từ website bán hàng |
file_type_category | object | Nhóm của từng phần mở rộng, vd {"jpg": "image", "pdf": "document"} |
date_created | int | Thời điểm trả dữ liệu (Unix timestamp) |
Ví dụ Response
{
"company_id": 1,
"quota": 1000000000,
"file_max_size": 26214400,
"file_max_size_mb": 25,
"file_max_size_by_category": {
"image": 10485760,
"video": 26214400,
"audio": 26214400,
"document": 26214400,
"archive": 26214400
},
"site_file_max_size": 5242880,
"allow_file_types": ["MOV", "MP3", "MP4", "PDF", "JPG", "JPEG", "PNG", "..."],
"site_allow_file_types": ["JPG", "JPEG", "PNG", "GIF", "WEBP", "HEIC", "PDF"],
"file_type_category": { "mov": "video", "pdf": "document", "jpg": "image" },
"date_created": 1760000000
}Cách kiểm tra một file
- Lấy phần mở rộng (chữ thường), kiểm tra có trong
allow_file_types(so sánh không phân biệt hoa thường). - Lấy nhóm từ
file_type_category, so sánh dung lượng file vớifile_max_size_by_category[nhóm]. - Nội dung file phải đúng định dạng của phần mở rộng (không đổi đuôi file); API trả
error_file_content_mismatchnếu không khớp. - Tổng dung lượng đã dùng cộng file mới không vượt
quota.
Mã lỗi khi vượt giới hạn: xem Upload File.