SECURE ACCESS

ĐĂNG NHẬP

Nhập email và mật khẩu để truy cập hệ thống quản lý tệp tin

SHA-256 · AES-256 · HTTP 206

Tên

Kích thước

Ngày tạo

Thao tác

Đang tải dữ liệu...

DUNG LƯỢNG TÀI KHOẢN

0 B / 5 GB 0%

TẢI TỆP LÊN

Kéo thả tệp vào đây
hoặc nhấp để chọn từ máy tính

5 GB QUOTA · SHA-256 · HTTP 206

BẢO MẬT & XÁC THỰC

Mọi Request API (trừ Auth & Public Share) cần đính kèm HTTP Header:

Authorization: Bearer <YOUR_API_KEY_OR_SESSION_TOKEN>

1. XÁC THỰC & TÀI KHOẢN (AUTH)

POST /api/auth/register Đăng ký tài khoản người dùng mới

REQUEST BODY (JSON)

{
  "email": "user@example.com",
  "password": "yourpassword123"
}

RESPONSE (201 CREATED)

{
  "user": { "id": "uuid-123", "email": "user@example.com", "storageLimit": 5368709120, "storageUsed": 0 },
  "token": "eyJhbGci..."
}

POST /api/auth/login Đăng nhập tài khoản lấy Session Token

REQUEST BODY (JSON)

{
  "email": "user@example.com",
  "password": "yourpassword123"
}

RESPONSE (200 OK)

{
  "user": { "id": "uuid-123", "email": "user@example.com" },
  "token": "eyJhbGci..."
}

GET /api/me Lấy thông tin tài khoản hiện tại & quota lưu trữ

RESPONSE (200 OK)

{
  "user": { "id": "uuid-123", "email": "user@example.com", "storageLimit": 5368709120, "storageUsed": 1048576 }
}

2. PHÂN LUỒNG TỆP TIN & THƯ MỤC (FILES & FOLDERS)

GET /api/files Xem danh sách tệp & thư mục (Truyền query ?folderId=<id>)

QUERY PARAMETERS

folderId (optional): ID thư mục cần xem (Bỏ trống = Root)

RESPONSE (200 OK)

{
  "files": [
    { "id": "file-1", "name": "document.pdf", "size": 204800, "mimeType": "application/pdf", "folderId": null }
  ],
  "folders": [
    { "id": "folder-1", "name": "Dự Án A", "parentId": null }
  ],
  "currentFolder": null
}

POST /api/files/upload Tải tệp lên hệ thống (Binary Direct Stream)

HEADERS BẮT BUỘC

Content-Type: MIME type của file (VD: application/zip)

Content-Length: Kích thước file tính theo bytes

X-File-Name: Tên file mã hóa URL-encoded

RESPONSE (201 CREATED)

{
  "file": { "id": "file-uuid-99", "name": "archive.zip", "size": 10485760, "mimeType": "application/zip", "folderId": null }
}

GET /api/files/:id/download Tải xuống tệp tin (Hỗ trợ Header Range: bytes=0-1024)

RESPONSE

Binary File Stream (Attachment / Inline content)

PATCH /api/files/:id Đổi tên hoặc di chuyển tệp tin

REQUEST BODY (JSON)

{
  "name": "ten_moi.pdf",
  "folderId": "folder-uuid-123"
}

DELETE /api/files/:id Xóa tệp tin khỏi hệ thống

RESPONSE (200 OK)

{ "ok": true }

POST /api/folders Tạo thư mục mới

REQUEST BODY (JSON)

{
  "name": "Thư mục mới",
  "parentId": null
}

DELETE /api/folders/:id Xóa thư mục (Xóa đệ quy toàn bộ con)

RESPONSE (200 OK)

{ "ok": true }

3. QUẢN LÝ KHÓA TRUY CẬP (API KEYS)

GET /api/keys Lấy danh sách các API Keys hiện có

RESPONSE (200 OK)

{
  "keys": [
    { "id": "key-1", "name": "App Web Client", "scopes": ["read", "write"], "status": "active" }
  ]
}

POST /api/keys Tạo API Key mới

REQUEST BODY (JSON)

{
  "name": "Mobile App API Key",
  "scopes": ["read", "write", "delete"]
}

GET /api/keys/:id/reveal Giải mã xem lại chuỗi khóa API bí mật (fk_live_...)

RESPONSE (200 OK)

{ "secret": "fk_live_abc123xyz..." }

4. LIÊN KẾT CHIA SẺ (SHARES)

POST /api/files/:id/shares Tạo liên kết chia sẻ tệp tin công khai

REQUEST BODY (JSON)

{
  "password": "optional_password",
  "maxDownloads": 5,
  "expiresAt": "2026-12-31"
}

GET /share/:token Trang Tải Xuống công khai cho người xem

RESPONSE

Public HTML Download Landing Page