API Docs — Kho file muse-vm

Kiểm tra server còn sống. Luôn trả:

curl $BASE/health
# {"status": "ok"}

Thống kê dung lượng đĩa và số file trong kho.

curl -H "Authorization: Bearer $TOKEN" $BASE/stats
# {"total": 161057947648, "free": 158..., "disk_used": ...,
#  "files": 15, "files_bytes": 2488776781}

Liệt kê toàn bộ file trong kho (mảng JSON, sắp xếp theo tên).

curl -H "Authorization: Bearer $TOKEN" $BASE/files
# [{"name": "phim.mp4", "size": 1512345678, "mtime": 1762345678}, ...]

size tính bằng byte; mtime là thời gian sửa cuối dạng Unix epoch (giây).

Tải file lên. Tên file gửi qua header X-Filename (URL-encode), nội dung file là body thô (raw). Giới hạn 16 GB/file.

curl -X POST --data-binary @phim.mp4 \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Filename: phim.mp4" \
  $BASE/upload
# 201 {"name": "phim.mp4", "size": 1512345678, "sha256": "…"}

Tải lên / ghi đè một file theo tên (tương đương POST /upload nhưng tên nằm trên URL).

curl -T truyen.pdf -H "Authorization: Bearer $TOKEN" $BASE/files/truyen.pdf
# 201 {"name": "truyen.pdf", "size": ..., "sha256": "…"}

Tải file về. Hỗ trợ Range request (trả 206 + Content-Range) nên trình duyệt xem phim/audio sẽ tua và phát theo đoạn được. Kèm header Content-Disposition: attachment.

curl -H "Authorization: Bearer $TOKEN" -O $BASE/files/phim.mp4
# hoặc mở thẳng trên trình duyệt (token qua query):
# $BASE/files/phim.mp4?token=$TOKEN

Xóa một file khỏi kho. Thao tác không hoàn tác được.

curl -X DELETE -H "Authorization: Bearer $TOKEN" $BASE/files/phim.mp4
# {"deleted": "phim.mp4"}

Liệt kê mọi folder kèm số file và tổng dung lượng. Phần tử đầu tiên luôn là thư mục gốc (name rỗng).

curl -H "Authorization: Bearer $TOKEN" $BASE/folders
# [{"name": "", "files": 16, "bytes": ...},
#  {"name": "phim", "files": 3, "bytes": ...}]

Tạo folder mới (body JSON).

curl -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "phim"}' $BASE/folders
# 201 {"folder": "phim"}

Upload thẳng vào một folder bằng header X-Folder:

curl -X POST --data-binary @tap1.mp4 \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Filename: tap1.mp4" -H "X-Folder: phim" \
  $BASE/upload

Chuyển một file giữa các folder (body JSON: name, src, dst; để trống nghĩa là thư mục gốc). Folder đích chưa có sẽ tự tạo; nếu đích đã có file trùng tên, API trả 409.

curl -X POST -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "tap1.mp4", "src": "", "dst": "phim"}' $BASE/move
# {"moved": "tap1.mp4", "to": "phim"}

Xóa một folder và toàn bộ file trong đó. Không xóa được thư mục gốc.

curl -X DELETE -H "Authorization: Bearer $TOKEN" $BASE/folders/phim
# {"deleted_folder": "phim", "files": 3}