SaaS API가이드라인 Trial (데모)
입력 처리 + 트라이얼 생성 (Step 1)
카테고리/국가/제품명/상세이미지를 1회 처리해 campaignData 를 만들고 trial 세션을 생성합니다.
입력 처리 + 트라이얼 생성 (prepare)
Python /report/guideline/v4/prepare 를 호출해 상세페이지 이미지를 분석(image_analysis)한 campaignData 를 만들고, MongoDB guideline_trials 에 저장한 뒤 trialId(UUID) 를 발급합니다. 이후 모든 스텝은 이 trialId 로 호출합니다.
HTTP 요청
POST /ai/guideline/trial/prepare
Content-Type: application/json인증 불필요 (permitAll).
Request Body
{
"title": "워터풀 진정 세럼",
"category": "BEAUTY",
"nation": "KR",
"productImageUrls": ["https://{bucket}.s3.{region}.amazonaws.com/guideline/generation/trial/...detail1.jpg"]
}| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
title | String | 아니오 | 제품명 |
category | String | 아니오 | 카테고리 enum (BEAUTY·FASHION·FOOD·IT·HEALTH·TRAVEL 등, 기본 ETC) |
nation | String | 아니오 | 국가 코드 (기본 KR) |
productImageUrls | Array<String> | 아니오 | 상세페이지 이미지 URL (upload-url 로 업로드) |
응답 (200 OK)
{
"status": 200,
"message": "트라이얼 생성 완료",
"data": {
"trialId": "a7f3e9c1-4b2d-8e6f-1a0c-9d5b3f7e2c8a",
"campaignData": {
"title": "...", "category": "BEAUTY", "nation": "KR",
"image_analysis": { "product_name": "...", "key_features": ["..."] }
}
}
}부가 처리
campaignData(image_analysis 포함)를guideline_trials문서에 저장 — 이후 스텝에campaign_data_override로 재사용 (재분석 없음)status = DRAFT,expiresAt= 현재 + 48시간