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개 후보 |
selectedConcept | 사용자가 선택한 컨셉 |
data | 가이드라인 본문 (Python 응답이 그대로 저장됨) |
pdfMetadata | Python 이 생성한 PDF 메타정보 |
referenceMetadata | 참고 릴스 영상 흐름 메타데이터. concepts 단계에서 생성, 이후 단계에 재전달됨. 릴스 없으면 null |
providedOptions | 캠페인 제공 옵션 정의 (RDB 단일 진실, Mongo doc 미저장). 정의가 없으면 빈 배열 |
canEditGuideline | 광고주가 현재 가이드라인을 수정할 수 있는지 여부 (FE 수정 버튼 노출용). 모집 단계는 어드민이 수정 허용을 켠 경우에만 true (1회용: 광고주가 완성본을 한 번 저장하면 소진되어 다시 false, 어드민 재허용 필요). 콘텐츠 제작 단계 이후에는 false |
에러
- 세션 미존재:
"V4 세션이 없습니다. 컨셉 생성부터 시작하세요."