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 测试台完成认证并安全地测试。
打开测试台 →