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 플레이그라운드에서 인증하고 안전하게 테스트하세요.
플레이그라운드 열기 →