SaaS API가이드라인 V2 API

가이드라인 V2 개요

콘텐츠 가이드라인 V2 API 개요

가이드라인 V2 API

콘텐츠 가이드라인 V2는 기존 가이드라인 시스템을 고도화한 버전입니다.

주요 변경사항

검수 유형 선택: 대본 검수(2회 검수, 인당 3만원 추가) / 대본 없이(1회 검수)
카테고리별 촬영 상세: 9개 카테고리별 기본 항목 + 단가 상승 항목
Lexical 에디터: 소구 포인트, 프로모션, 주의사항 등을 Lexical JSON으로 저장
추가금 관리: TB_CAMPAIGN_ADDON_FEE 테이블에 인당 추가금 저장

기본 경로

/ai/guideline/v2

인증

모든 API는 JWT Bearer 토큰 인증이 필요합니다.

가이드라인 상태

상태	설명	MongoDB status	RDB guidelineStatus	CampaignSubStep
임시저장	내용만 저장 (isModify=true)	변경 없음	변경 없음	변경 없음
초안	광고주에게 전송 (isFirst=true)	`DRAFT`	`DRAFT`	`CAMPAIGN_GUIDELINE`
완성본	최종 저장 (isFirst=false)	`COMPLETED`	`COMPLETED`	`CREATOR_RECRUIT`

가이드라인 버전 판별

캠페인 조회 API 응답에 guidelineVersion 필드가 포함됩니다.

guidelineVersion	사용할 API	설명
`1` (또는 null)	`/ai/guideline/{collabNo}` (v1)	기존 가이드라인
`2`	`/ai/guideline/v2/{collabNo}` (v2)	신규 가이드라인

이 필드는 다음 API 응답에서 확인 가능합니다:

GET /ai/admin/campaigns/{campaignNo} → guidelineVersion
GET /ai/collab/{campaignNo}/full → campaign.guidelineVersion

데이터 저장 구조

데이터	저장소	설명
가이드라인 내용 (4단계 위저드)	MongoDB `guidelines` 컬렉션	유연한 JSON 구조, 스키마 변경 없이 확장 가능
가이드라인 메타데이터	MariaDB `TB_COLLAB`	`guidelineVersion`, `guidelineStatus`, `keywords` 등
추가금	MariaDB `TB_CAMPAIGN_ADDON_FEE`	대본 검수 인당 3만원 등

4단계 위저드 구조

Step	이름	설명
0	검수 유형 선택	대본 검수 여부 (추가금 발생)
1	콘텐츠 내용	소구 포인트, 프로모션, 주의사항, 해시태그
2	촬영 상세	카테고리별 기본 항목 + 단가 상승 항목
3	업로드 설정	브랜드 태그, 협찬 레이블, 자동DM 등
4	스토리라인/자료	레퍼런스 링크, 컨셉, 브랜드 로고, 사진 자료

캠페인 예산 요약 조회

캠페인의 총 예산, 소요 크레딧, 환급 가능 금액을 조회합니다.

PUT /ai/guideline/v2/{collabNo}

가이드라인 V2 저장 (Upsert)

On this page

가이드라인 V2 API

주요 변경사항

가이드라인 상태

가이드라인 버전 판별

데이터 저장 구조

4단계 위저드 구조