Glowb Dev Docs
Main API

캠페인 상세 조회 API

캠페인 상세 정보 및 가이드라인 조회 API

캠페인 상세 조회 API

캠페인의 상세 정보와 가이드라인을 조회하는 API입니다.

Base URL: /ai/collab

인증 정보

항목값
인증 필요네
인증 방식Bearer token

엔드포인트 목록

메서드경로설명비고
GET/ai/collab/{campaignNo}/detail캠페인 상세 조회 (SaaS 이전)레거시
GET/ai/collab/{campaignNo}/full캠페인 상세 + 가이드라인 조회 (SaaS 이후)신규

API 상세

캠페인 상세 + 가이드라인 조회 (SaaS)

캠페인의 상세 정보와 가이드라인을 함께 조회합니다.

인플루언서 권한(role=0)으로 로그인한 경우, 해당 캠페인에 대한 신청 여부(hasApplied)가 함께 반환됩니다.

HTTP 요청

GET /ai/collab/{campaignNo}/full

Path Parameters

파라미터타입필수설명
campaignNolong예캠페인 번호

응답

성공 응답 (200 OK)

{
  "status": 200,
  "code": null,
  "message": "캠페인 상세 조회 완료",
  "data": {
    "campaign": {
      "no": "1328",
      "businessId": "business_001",
      "thumbnailImagePath": "https://s3.../thumbnail.jpg",
      "productImagePath": "https://s3.../product.jpg",
      "productImagePaths": [
        "https://s3.../product1.jpg",
        "https://s3.../product2.jpg"
      ],
      "snsType": "INSTAGRAM",
      "contentFormat": "REEL",
      "category": "BEAUTY",
      "campaignType": "SEEDING",
      "campaignSubStep": "CREATOR_RECRUIT",
      "productName": "상품명",
      "charge": "100000",
      "currency": "KRW",
      "recruitCount": "10",
      "recruitmentStartDate": "2024-01-01 00:00:00",
      "recruitmentEndDate": "2024-01-31 23:59:59",
      "daysSinceEnded": null,
      "campaignContractType": "STANDARD",
      "campaignContractDescription": "계약 설명",
      "campaignReportUrl": null,
      "showPrice": true,
      "listMode": "EXCLUDE",
      "firstReviewTypes": ["DRAFT", "CAPTION"],
      "secondReviewTypes": ["FINAL_CONTENT"],
      "finalSubmissionTypes": ["INSIGHT"],
      "secondaryUsageOption": "ALLOWED"
    },
    "guideline": {
      "collabNo": 1328,
      "createdAt": "2024-01-15T10:00:00",
      "updatedAt": "2024-01-16T15:30:00",
      "basicInfo": {
        "brandName": "브랜드명",
        "productName": "상품명",
        "productDescription": "상품 설명"
      },
      "contentDetailInfo": {
        "concept": "콘텐츠 컨셉",
        "mustInclude": ["필수 포함 사항"],
        "prohibited": ["금지 사항"]
      },
      "marketingInfo": {
        "hashtags": ["#해시태그1", "#해시태그2"],
        "mentions": ["@계정1"]
      },
      "detailPageInfo": {
        "brandLogo": {
          "imageUrl": "https://s3.../logo.jpg"
        },
        "thumbnailUrl": "https://s3.../thumbnail.jpg",
        "detailImageUrls": [
          "https://s3.../detail1.jpg",
          "https://s3.../detail2.jpg"
        ]
      }
    },
    "hasGuideline": true,
    "hasApplied": true,
    "schedules": [
      {
        "scheduleId": 1,
        "phase": "RECRUITMENT",
        "startDate": "2024-01-01T00:00:00",
        "endDate": "2024-01-07T23:59:59",
        "completedDate": "2024-01-06T15:30:00",
        "isCompleted": true,
        "isDelayed": false,
        "memo": null,
        "createdAt": "2024-01-01T00:00:00",
        "updatedAt": "2024-01-06T15:30:00"
      },
      {
        "scheduleId": 2,
        "phase": "EXCLUSION_SELECTION",
        "startDate": "2024-01-08T00:00:00",
        "endDate": "2024-01-10T23:59:59",
        "completedDate": null,
        "isCompleted": false,
        "isDelayed": false,
        "memo": null,
        "createdAt": "2024-01-01T00:00:00",
        "updatedAt": null
      }
    ]
  }
}

Response 스키마

CampaignWithGuidelineResponseDto

필드명타입설명
campaignCampaignFullResponseDto캠페인 상세 정보
guidelineMap<String, Object>가이드라인 정보 (DynamoDB)
hasGuidelineboolean가이드라인 존재 여부
hasAppliedBoolean인플루언서의 캠페인 신청 여부 (인플루언서 권한인 경우에만 반환, 그 외 null)
schedulesCampaignScheduleResponseDto[]캠페인 일정 목록

CampaignScheduleResponseDto

필드명타입설명
scheduleIdlong일정 ID
phaseCampaignPhase캠페인 단계
startDatedatetime단계 시작일
endDatedatetime단계 종료일
completedDatedatetime실제 완료일 (nullable)
isCompletedboolean완료 여부
isDelayedboolean지연 여부
memostring메모 (nullable)
createdAtdatetime생성일
updatedAtdatetime수정일 (nullable)

CampaignFullResponseDto

필드명타입설명
nostring캠페인 번호
businessIdstring기업 ID
thumbnailImagePathstring썸네일 이미지 경로
productImagePathstring제품 이미지 경로
productImagePathsstring[]제품 이미지 경로 목록
snsTypeSnsTypeSNS 타입
contentFormatSnsContentFormat콘텐츠 형식
categoryCategoryType카테고리
campaignTypeCampaignType캠페인 타입
campaignSubStepCampaignSubStep캠페인 세부 단계
productNamestring제품명
chargestring단가
currencystring통화
recruitCountstring모집 인원
recruitmentStartDatedatetime모집 시작일
recruitmentEndDatedatetime모집 종료일
daysSinceEndedint종료 후 경과일
campaignContractTypestring계약 타입
campaignContractDescriptionstring계약 설명
campaignReportUrlstring캠페인 리포트 URL
showPriceboolean가격 노출 여부
listModeListMode리스트 모드
firstReviewTypesSet<SubmissionItemType>1차 검수 필수 제출물
secondReviewTypesSet<SubmissionItemType>2차 검수 필수 제출물
finalSubmissionTypesSet<FinalSubmissionType>최종 제출물 타입
secondaryUsageOptionstring2차 활용 옵션

캠페인 상세 조회 (레거시)

캠페인의 기본 상세 정보만 조회합니다. (가이드라인 미포함)

HTTP 요청

GET /ai/collab/{campaignNo}/detail

Path Parameters

파라미터타입필수설명
campaignNolong예캠페인 번호

응답

성공 응답 (200 OK)

{
  "status": 200,
  "code": null,
  "message": "캠페인 상세 조회 완료",
  "data": {
    // CampaignDetailResponseDto 필드들
  }
}

Enum 값

SnsType

값설명
INSTAGRAM인스타그램
YOUTUBE유튜브
TIKTOK틱톡
BLOG블로그

CampaignType

값설명
SEEDING시딩
ADVERTISEMENT광고
AFFILIATE어필리에이트

CampaignSubStep

값설명
CREATOR_RECRUIT크리에이터 모집
CONTENT_CREATION콘텐츠 제작
CONTENT_REVIEW콘텐츠 검수
COMPLETED완료

CampaignPhase

캠페인 일정 단계를 나타냅니다.

값설명순서기본 소요일
RECRUITMENT모집1기준점
EXCLUSION_SELECTION협업 제안22일
CONTRACT_CREATION계약서 작성32일
DRAFT_SUBMISSION제품 배송44일
DRAFT_REVIEW제작물 1차 제출54일
VIDEO_PRODUCTION검수 및 업로드 허용62일
VIDEO_REVIEW재제출 or 업로드73일
UPLOAD최종 업로드 허용82일
UPLOAD_APPROVAL최종업로드93일
SETTLEMENT정산1021일

에러 응답

상태 코드에러 코드설명
404NOT_FOUND캠페인을 찾을 수 없음
500SERVER_ERROR서버 내부 오류

API 테스트

캠페인 상세 + 가이드라인 조회 (SaaS)

캠페인 상세 조회 (레거시)

GET /influence/{business_id}/proposal/{influence_id}

역제안 조회

캠페인 지원 API

캠페인 지원자 관리 API

On this page

캠페인 상세 조회 API
인증 정보
엔드포인트 목록
API 상세
캠페인 상세 + 가이드라인 조회 (SaaS)
Path Parameters
응답
Response 스키마
캠페인 상세 조회 (레거시)
Path Parameters
응답
Enum 값
SnsType
CampaignType
CampaignSubStep
CampaignPhase
에러 응답
API 테스트
캠페인 상세 + 가이드라인 조회 (SaaS)
캠페인 상세 조회 (레거시)