SaaS API가이드라인 Trial (데모)
업로드용 presigned URL 발급 (Step 0)
상세페이지 이미지 / 가이드 PDF 를 S3 에 직접 올리기 위한 presigned PUT URL 을 발급합니다. (무인증)
업로드용 presigned URL 발급
기존 V4 업로드와 동일한 S3 버킷·경로·URL 형식을 유지한 채, 방식만 멀티파트 → S3 presigned PUT 으로 바꾼 엔드포인트다. 발급받은 uploadUrl 로 프론트가 파일을 직접 PUT 한 뒤, publicUrl 을 prepare 의 productImageUrls 또는 concepts 의 fileUrls 에 담아 보낸다.
HTTP 요청
POST /ai/guideline/trial/upload-url
Content-Type: application/json인증 불필요 (permitAll).
Request Body
{
"filename": "detail.jpg",
"contentType": "image/jpeg"
}| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
filename | String | 예 | 원본 파일명 |
contentType | String | 아니오 | 브라우저 file.type. presigned 서명에 바인딩됨 (주로 이미지 / PDF) |
응답 (200 OK)
{
"status": 200,
"message": "발급 완료",
"data": {
"uploadUrl": "https://{bucket}.s3.{region}.amazonaws.com/guideline/generation/trial/...&X-Amz-Signature=...",
"publicUrl": "https://{bucket}.s3.{region}.amazonaws.com/guideline/generation/trial/..."
}
}| 필드 | 설명 |
|---|---|
uploadUrl | 브라우저가 파일을 올릴 S3 presigned PUT URL (PUT + 본문 = 파일 바이트, Content-Type 헤더 일치) |
publicUrl | 업로드 완료 후 prepare/concepts 에 넘길 S3 객체 URL |
위치
- 스토리지: V4 업로드와 동일한 S3 버킷(
cloud.aws.s3.bucketName) - 키:
guideline/generation/trial/{timestamp}_{uuid}_{filename}(V4의guideline/generation/{collabNo}/와 동일 트리, 캠페인이 없어 collabNo 자리만trial) - presigned URL 만료: 30분