POST
/api/v1/files/upload授權檔案上傳
為私人來源檔案建立有上限的上傳流程。
驗證
API 金鑰
權限範圍
files:write
契約
API v1
請求
curl -X POST 'https://api.maxscanner.app/api/v1/files/upload' \
-H 'Authorization: Bearer $MAXSCANNER_API_KEY' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: unique-request-id' \
-d '{ "filename": "scan.pdf", "contentType": "application/pdf", "sizeBytes": 1048576 }'請求本文
{ "filename": "scan.pdf", "contentType": "application/pdf", "sizeBytes": 1048576 }回應
{ "uploadUrl": "…", "sourceKey": "…", "expiresAt": "…" }實作說明
- 上傳 URL 的有效期限很短。
- 處理前請驗證檔案大小與類型。
試用此端點
將端點接入應用程式之前，先用 API 測試台完成驗證並安全地測試。
開啟測試台 →