文件上傳

使用說明與限制

• 權杖 (Token):
  • 輸入您的固定密碼，或 Authenticator App 產生的目前6位數驗證碼。
  • 請向管理員確認您應使用的權杖類型及對應的密碼或設定方式。
• TOTP 設定說明: 若您使用 TOTP 認證，您需要將管理員提供的 Base32 密鑰手動添加到您的 Authenticator App (如 Google Authenticator, Authy 等)。請妥善保管此密鑰。
• 單次上傳檔案大小上限: 每個檔案不得超過 100MB。
• 檔名長度: 原始檔名長度必須小於 70 個字元。
• 檔案保留期限: 上傳的檔案最多保留 7 天，之後將自動從伺服器刪除。請務必在此期限內下載所需檔案。
• 上傳方式:
  • 可透過本頁面上方表單上傳。
  • 可透過 API (例如 cURL) 以上述任一認證方式上傳。
• 成功回應: 上傳成功後，會返回 JSON 格式的回應，包含：
  • message: 狀態訊息。
  • fileName: 伺服器儲存的帶時間戳檔名。
  • downloadUrlTemplate: 下載檔案的 URL 模板 (QR Code 將指向此模板)。
  • 若提供有效權杖，將額外顯示包含該權杖的「實際下載連結」。

API 串接範例 (使用 cURL)

請將範例中的 YOUR_KEY_OR_OTP, YOUR_FILE_PATH, 和 YOUR_FILENAME.EXT 替換為您的實際值。

1. 表單方式 (multipart/form-data):

curl -X POST \
-F "token=YOUR_KEY_OR_OTP" \
-F "file=@YOUR_FILE_PATH/YOUR_FILENAME.EXT" \
https://upload.stkcpu.cc/

2. 直接串流 (路徑參數):

此方式將權杖和檔名放在 URL 路徑中。

curl -X POST \
--data-binary "@YOUR_FILE_PATH/YOUR_FILENAME.EXT" \
-H "Content-Type: application/octet-stream" \
https://upload.stkcpu.cc/YOUR_KEY_OR_OTP/YOUR_FILENAME.EXT

下載檔案

上傳成功後返回的 downloadUrlTemplate 格式如下 (QR Code 會指向此模板)：

https://upload.stkcpu.cc/get_file/YYYYMMDDHHMMSS-YOUR_FILENAME.EXT?token=YOUR_TOKEN_HERE

您需要將 YOUR_TOKEN_HERE 替換為有效的密碼或當前的OTP來下載。或者，如果上傳時提供了權杖，頁面上會直接顯示一個包含該權杖的「實際下載連結」。例如使用 curl:

curl -L -o "DOWNLOADED_FILENAME.EXT" "https://upload.stkcpu.cc/get_file/YYYYMMDDHHMMSS-YOUR_FILENAME.EXT?token=YOUR_ACTUAL_TOKEN"