[2단계] 스토리지에 이미지 업로드
POST/storage/upload
이미지 업로드 워크플로우의 두 번째 단계 - 세이프티스냅 스토리지 직접 업로드
1단계에서 받은 업로드 URL을 사용해 실제 파일을 세이프티스냅 스토리지에 업로드합니다.
📋 이 단계에서 수행할 작업
- 1단계에서 받은 정보 사용: 업로드 URL 응답의
upload_url을 엔드포인트로 사용 - 필수 필드와 파일 데이터 전송: 1단계에서 받은
fields객체의 모든 필드들과 실제 파일 데이터를 함께 전송 - multipart/form-data로 업로드: 스토리지 서비스가 요구하는 형식으로 업로드
⚠️ 중요 사항
- 실제 URL은 동적 생성: 이
/storage/upload은 예시이며, 실제로는 1단계에서 받은upload_url을 사용 - Content-Type 필수:
multipart/form-data로 설정 - 모든 필드 포함 필수: 1단계에서 받은
fields객체의 모든 키-값 쌍을 빠짐없이 multipart form-data에 포함해야 합니다. 필드를 하나라도 누락하면 업로드가 실패합니다.
다음 단계
업로드 성공 후 → 3단계 /complete/ 엔드포인트로 세이프티스냅에 완료 알림
Request
Responses
- 204
- 400
- 401
- 403
- 404
- 500
업로드 성공 (응답 본문 없음)
잘못된 요청 (필수 필드 누락 또는 파일 오류)
인증 실패
권한 없음 (잘못된 signature 또는 만료된 presigned URL)
리소스를 찾을 수 없음
서버 내부 오류