SaaS API가이드라인 V4
세션 상태 조회
V4 가이드라인 세션의 현재 상태를 조회합니다.
세션 상태 조회
V4 가이드라인 작성 진행 상태와 누적된 데이터를 조회합니다.
HTTP 요청
GET /ai/guideline/v4/{collabNo}/session
Authorization: Bearer {access_token}응답
{
"status": 200,
"code": null,
"message": "세션 조회 완료",
"data": {
"collabNo": 123,
"status": "GUIDELINE_GENERATED",
"concepts": [ ... ],
"selectedConcept": { ... },
"data": {
"shots": { "beginning": [...], "middle": [...], "ending": [...] },
"required_appeal_points": [...],
"hashtags": ["#태그1"]
},
"pdfMetadata": { ... },
"referenceMetadata": {
"reels_metadata": [ ... ]
},
"createdAt": "2026-05-15T...",
"updatedAt": "2026-05-15T...",
"providedOptions": [
{
"id": 1,
"title": "색상",
"selectionType": "SINGLE",
"sortOrder": 0,
"choices": [
{ "id": 11, "value": "아이보리", "sortOrder": 0 },
{ "id": 12, "value": "그레이", "sortOrder": 1 }
]
}
],
"canEditGuideline": false
}
}| 필드 | 설명 |
|---|---|
status | CONCEPTS_GENERATED / GUIDELINE_GENERATED / EDITING / DRAFT / COMPLETED |
concepts | 컨셉 3개 후보. V5 트렌드 컨셉(trend_context 보유)은 공개 필드로 축약되어 내려감 (아래 참고) |
selectedConcept | 사용자가 선택한 컨셉. concepts 와 동일한 축약 규칙 적용 |
data | 가이드라인 본문 (Python 응답이 그대로 저장됨). V5 로 생성된 경우 trend_application_summary 는 제거되어 내려감 |
pdfMetadata | Python 이 생성한 PDF 메타정보 |
referenceMetadata | 참고 릴스 영상 흐름 메타데이터. concepts 단계에서 생성, 이후 단계에 재전달됨. 릴스 없으면 null |
providedOptions | 캠페인 제공 옵션 정의 (RDB 단일 진실, Mongo doc 미저장). 정의가 없으면 빈 배열 |
canEditGuideline | 광고주가 현재 가이드라인을 수정할 수 있는지 여부 (FE 수정 버튼 노출용). 모집 단계는 어드민이 수정 허용을 켠 경우에만 true (1회용: 광고주가 완성본을 한 번 저장하면 소진되어 다시 false, 어드민 재허용 필요). 콘텐츠 제작 단계 이후에는 false |
V5 트렌드 컨셉 축약
세션의 컨셉이 가이드라인 V5 로 생성된 경우(trend_context 보유), concepts / selectedConcept 는 아래 형태로 축약되어 내려갑니다. Mongo 원본은 그대로 보관되며 응답만 축약됩니다.
{
"name": "컨셉 이름",
"description": "컨셉 설명",
"one_liner": "한 줄 요약",
"trend_name": "선정된 트렌드 주제",
"why_selected": "이 트렌드를 고른 이유",
"application_points": ["가이드 적용 방식"],
"reference_reels": [
{
"source_url": "https://www.instagram.com/reel/abc123/",
"observed_pattern": "반복 관찰된 연출 패턴"
}
]
}trend_context 가 없는 기존 V4 컨셉(name / description / one_liner)은 저장된 형태 그대로 반환됩니다.
또한 data.trend_application_summary 는 위 컨셉 필드와 내용이 겹치므로 응답에서 제거됩니다. 이 필드가 저장되어 있던 기존 세션도 조회 시 제거된 형태로 내려갑니다(Mongo 원본은 유지).
에러
- 세션 미존재:
"V4 세션이 없습니다. 컨셉 생성부터 시작하세요."