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 プレイグラウンドで認証して安全にテストしましょう。
プレイグラウンドを開く →