API Uploadex tham chiếu.

API của Uploadex cho phép bạn tải tệp lên, liệt kê tệp và cập nhật siêu dữ liệu bằng lập trình, thay mặt cho chủ sở hữu khóa API. Mỗi điểm cuối là một tài nguyên REST: đầu vào là JSON (hoặc multipart cho tệp tải lên dạng nhị phân), đầu ra là JSON, chỉ dùng HTTPS.

• URL gốc https://uploadex.net/api/v1
• Xác thực Mã thông báo Bearer trong header Authorization
• Truyền tải Chỉ HTTPS · TLS 1.2 hoặc 1.3
• Mã hóa UTF-8 JSON · multipart/form-data for lượt tải lên
• Ngày tháng ISO 8601 theo UTC · 2026-04-21T08:12:04Z

Mọi yêu cầu phải bao gồm một header Authorization với mã thông báo Bearer. Tạo và luân chuyển khóa từ bảng điều khiển nhà phát triển của bạn.

Authorization: Bearer ux_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Các khóa bắt đầu bằng ux_live_. Chúng chỉ được hiển thị đúng một lần khi tạo — hãy lưu chúng trong một trình quản lý bí mật. Các khóa có thể được giới hạn phạm vi cho các hành động cụ thể (files:read, files:write, upload, hoặc *) và được đặt hết hạn vào một ngày trong tương lai.

Truy xuất thông tin tài khoản của bạn để xác nhận khóa hoạt động.

# Get your account info
curl https://uploadex.net/api/v1/account \
  -H "Authorization: Bearer $UX_API_KEY"

{
  "data": {
    "id":               "clxxxxxxxxxxxxxxxxxxxxxx",
    "email":            "[email protected]",
    "name":             "Your Name",
    "plan":             "PRO",
    "balance":          0,
    "totalEarnings":    0,
    "storageUsed":      52428800,
    "storageLimit":     53687091200,
    "storageFormatted": "50 MB / 50 GB",
    "fileCount":        3,
    "createdAt":        "2026-04-01T09:21:00.000Z"
  }
}

Giới hạn tải lên và lưu trữ được quyết định theo gói và có thể thay đổi khi tài khoản nâng cấp hoặc hạ cấp. Giới hạn cho các gói bao gồm truy cập API:

Giới hạn tốc độ bảo vệ dịch vụ khỏi lưu lượng vượt tầm kiểm soát. Vượt quá giới hạn sẽ trả về 429 Too Many Requests.

Lỗi responses use standard HTTP trạng thái codes and a consistent JSON body.

{ "error": "Invalid or missing API key" }

List Điểm cuốis use page-based pagination. Pass page (1-indexed) and limit (max 100) as query parameters.

GET /api/v1/files?page=1&limit=50

Scope: no scope Bắt buộc beyond a valid key.

Phạm vi: upload. Trả về 413 nếu size vượt quá giới hạn gói của tài khoản.

{
  "data": {
    "id":            "clxxxxxxxxxxxxxxxxxxxxxx",
    "slug":          "9nK2xA",
    "filename":      "demo.mp4",
    "size":          881975296,
    "sizeFormatted": "841.1 MB",
    "mimeType":      "video/mp4",
    "status":        "READY",
    "scanStatus":    "CLEAN",
    "downloads":     128,
    "views":         412,
    "tags":          ["demo"],
    "visibility":    "PUBLIC",
    "adsEnabled":    true,
    "createdAt":     "2026-04-21T08:12:04.000Z",
    "updatedAt":     "2026-04-21T08:12:04.000Z"
  }
}

Phạm vi: GET yêu cầu files:read; PATCH/DELETE yêu cầu files:write.