Glowb Dev Docs
테스트 데이터 세팅

캠페인 생성

모집 중 상태의 테스트 캠페인을 만듭니다. 채널·국가·검수 회차·배송 유형만 고르면 나머지는 운영 뷰티 캠페인 스냅샷으로 채워집니다.

캠페인 생성

모집 중(CREATOR_RECRUIT) 상태의 캠페인을 만듭니다. 크레딧 결제와 캠페인 단계별 일정 생성까지 함께 처리하므로, 호출 직후 바로 선정 단계로 넘어갈 수 있습니다.

가이드라인은 만들지 않습니다(guidelineStatus = REQUESTED). 가이드라인까지 필요하면 캠페인 + 가이드라인 생성을 쓰세요.

HTTP 요청

POST /ai/test-setup/campaign
Content-Type: application/json

인증 불필요 (permitAll). staging-saas 환경에서만 동작합니다.

Request Body

전부 선택값입니다. 빈 body 로 호출하면 국내 인스타 뷰티 2회검수 배송형이 만들어집니다.

{
  "businessId": "202604Q",
  "snsType": "INSTAGRAM",
  "nation": "KR",
  "doubleReview": true,
  "deliveryType": "DELIVERY",
  "person": "5",
  "charge": "1500000",
  "productName": "테스트 뷰티 디바이스"
}
필드타입기본값설명
businessIdString202604Q캠페인을 소유할 기업 계정 ID (test 기업 2026-4Q-TEST)
snsTypeEnumINSTAGRAMINSTAGRAM 또는 TIKTOK 지원. 콘텐츠 형식이 자동 결정됩니다
nationStringKRKR / US / JP. 통화가 자동 결정됩니다
doubleReviewBooleantruetrue = 스크립트 검수 후 영상 검수, false = 영상 검수만
deliveryTypeEnumDELIVERYDELIVERY / NO_DELIVERY / VISIT_REQUIRED
personString5모집 인원
chargeString1500000캠페인 예산. 크레딧 결제 금액이 됩니다
productNameString테스트 뷰티 디바이스제품명

자동 결정되는 값

입력파생값
snsType = INSTAGRAMsnsContentFormat = INSTAGRAM_REELS
snsType = TIKTOKsnsContentFormat = TIKTOK_SHORTS
nation = KRcurrency = KRW
nation = UScurrency = USD
nation = JPcurrency = JPY
doubleReview = truefirstReviewTypes = {SCRIPT_VIDEO}
doubleReview = falsefirstReviewTypes = {} (비어 있으면 1회검수로 판정)

운영에 국내 틱톡 캠페인 전례가 없습니다(신사스 틱톡은 미국 캠페인 1건뿐). 틱톡으로 만들 때 nation 을 무엇으로 둘지는 테스트 목적에 맞춰 고르세요. 해외(KR 이외)로 만들면 자동 메일이 전면 잠금이라 알림 흐름을 확인할 수 없습니다.

응답 (200 OK)

{
  "status": 200,
  "code": null,
  "message": "캠페인 생성 완료",
  "data": {
    "collabNo": 3201,
    "title": "자동생성-3201",
    "businessId": "202604Q",
    "snsType": "INSTAGRAM",
    "nation": "KR",
    "currency": "KRW",
    "doubleReview": true,
    "deliveryType": "DELIVERY",
    "campaignSubStep": "CREATOR_RECRUIT",
    "guidelineStatus": "REQUESTED"
  }
}

캠페인 번호가 DB 채번이라, 저장한 뒤에야 제목을 확정할 수 있습니다. 그래서 제목은 항상 자동생성-{collabNo} 형태가 됩니다. cleanup 이 이 접두사로 대상을 찾습니다.

함께 처리되는 것

처리내용
썸네일TB_COLLAB.imagePath 에 CDN 이미지 1장
상세페이지 이미지TB_COLLAB.productImagePath 에 CDN 이미지 4장 (쉼표로 이어 붙인 문자열)
제품 처리 정책is_visit_required = KEEP_AFTER_REVIEW (검수 후 소장 — 운영에서 가장 흔한 값)
키워드 / 어드민 코멘트keywords, etc_notes 프리셋
담당자기업의 대표 담당자를 찾아 자동으로 연결. 등록된 담당자가 없으면 비워 두고 넘어간다
상세이미지 분석TB_COLLAB.product_details 에 뷰티 분석 결과 프리셋 주입
크레딧 결제charge 금액만큼 캠페인 예산 입금 (크레딧 부족 시 자동 충전)
캠페인 일정모집 마감 다음 날부터 단계별 TB_CAMPAIGN_SCHEDULE 자동 생성
모집 기간오늘 00:00 ~ +14일

에러 응답

에러도 HTTP 는 200 이고, 실제 판정은 body 의 status 필드로 합니다. glowb 백엔드가 예외를 ApiResponse 로 감싸기 때문입니다.

{ "status": 404, "code": "INVALID_DATA", "message": "지원하지 않는 채널입니다. INSTAGRAM 또는 TIKTOK 만 가능합니다: NAVER", "data": null }
body status상황
404snsTypeINSTAGRAM/TIKTOK 이 아님
— (HTTP 404)해당 프로파일이 아니어서 엔드포인트가 없음 (운영 환경)

API 테스트

On this page