SaaS APICollab 이벤트 API
GET /ai/collab/{campaignNo}/full
캠페인 상세 조회 (캠페인 정보 + 가이드라인)
캠페인 상세 조회 (캠페인 정보 + 가이드라인)
캠페인 상세 정보와 가이드라인을 함께 조회합니다. 인플루언서 권한인 경우 캠페인 신청 여부도 함께 반환합니다.
| 항목 | 값 |
|---|---|
| 메서드 | GET |
| 경로 | /ai/collab/{campaignNo}/full |
| 인증 | 선택 (Bearer Token) |
요청
GET /ai/collab/1425/full HTTP/1.1
Host: api.glowb.com
Authorization: Bearer {access_token}curl -X GET "https://api.glowb.com/ai/collab/1425/full" \
-H "Authorization: Bearer {access_token}"const response = await fetch('/ai/collab/1425/full', {
headers: {
'Authorization': `Bearer ${accessToken}`
}
});
const result = await response.json();Path Parameters
Prop
Type
응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "캠페인 상세 조회 완료",
"data": {
"campaign": {
"no": "1425",
"businessId": "business123",
"title": "여름 뷰티 캠페인",
"thumbnailImagePath": "https://s3.../thumbnail.jpg",
"productImagePath": "https://s3.../product1.jpg,https://s3.../product2.jpg",
"productImagePaths": [
"https://s3.../product1.jpg",
"https://s3.../product2.jpg"
],
"snsType": "INSTAGRAM",
"contentFormat": "REELS",
"category": "BEAUTY",
"campaignType": "REVIEW",
"campaignSubStep": "CREATOR_RECRUIT",
"productName": "여름 선크림",
"charge": "100000",
"currency": "KRW",
"recruitCount": "10",
"daysSinceEnded": null,
"recruitmentStartDate": "2025-01-10 00:00:00",
"recruitmentEndDate": "2025-01-20 23:59:59",
"campaignContractType": "STANDARD",
"campaignContractDescription": "표준 계약",
"campaignReportUrl": null,
"showPrice": true,
"listMode": "PUBLIC",
"firstReviewTypes": ["SCRIPT_VIDEO"],
"secondReviewTypes": ["VIDEO", "CAPTION", "HASHTAG"],
"finalSubmissionTypes": ["POST_URL"],
"secondaryUsageOption": "ALLOWED",
"secondaryUsageMonths": 6,
"caution": "주의사항 내용",
"description": "캠페인 설명",
"hasGuideline": true
},
"guideline": {
"collabNo": 1425,
"createdAt": "2025-01-09T12:00:00Z",
"updatedAt": "2025-01-09T14:30:00Z",
"contentTypes": ["VIDEO", "CAPTION", "HASHTAG"],
"basicInfo": {
"productUrl": "https://example.com/product",
"contentConcepts": [
{
"code": "STORY_TELLING",
"referenceUrl": "https://instagram.com/reel/xxx",
"referenceDescription": "이 영상처럼 자연스러운 썰풀기 스타일로"
}
]
},
"contentDetailInfo": {
"categoryCode": "BEAUTY",
"basicShots": [
{
"code": "TEXTURE_SHOT",
"appealPoint": "크리미한 제형 표현",
"subOption": null
}
],
"additionalOptions": [
{
"code": "NARRATION",
"additionalPrice": 20000
}
]
},
"marketingInfo": {
"requiredPoints": ["SPF50+ 자외선 차단", "촉촉한 수분감"],
"optionalPoints": ["비건 인증"],
"videoMarketingOptions": {
"promotion": {
"referenceUrl": "https://example.com/promo",
"description": "6월 한정 20% 할인"
},
"brandAccountTag": {
"accountName": "@glowb_beauty",
"tagMethods": ["PERSON_TAG", "CAPTION_TAG"],
"saveAsDefault": true
},
"sponsorLabel": {
"accountName": "@glowb_official"
},
"collaborator": null,
"useAutoDm": false
},
"hashtags": ["#글로브뷰티", "#여름선크림"]
},
"detailPageInfo": {
"brandLogo": {
"imageUrl": "https://s3.../brand-logo.png",
"saveAsDefault": true
},
"thumbnailUrl": "https://s3.../thumbnail.jpg",
"detailImageUrls": ["https://s3.../detail-1.jpg", "https://s3.../detail-2.jpg"]
}
},
"hasGuideline": true,
"schedules": [
{
"scheduleId": 101,
"phase": "RECRUITMENT",
"startDate": "2025-01-10T00:00:00",
"endDate": "2025-01-20T23:59:59",
"completedDate": null,
"isCompleted": false,
"isDelayed": false,
"memo": null,
"createdAt": "2025-01-09T10:00:00",
"updatedAt": "2025-01-09T10:00:00"
},
{
"scheduleId": 102,
"phase": "FIRST_REVIEW",
"startDate": "2025-01-21T00:00:00",
"endDate": "2025-01-25T23:59:59",
"completedDate": null,
"isCompleted": false,
"isDelayed": false,
"memo": null,
"createdAt": "2025-01-09T10:00:00",
"updatedAt": "2025-01-09T10:00:00"
}
],
"hasApplied": false
}
}Response 스키마
최상위 필드
Prop
Type
campaign (캠페인 상세 정보)
Prop
Type
campaignSubStep 값:
CAMPAIGN_REVIEW: 캠페인 검토CAMPAIGN_PAYMENT: 결제 대기CAMPAIGN_GUIDELINE: 가이드라인 작성CREATOR_RECRUIT: 크리에이터 모집CREATOR_SELECT: 크리에이터 선정FIRST_REVIEW: 1차 검수SECOND_REVIEW: 2차 검수POSTING: 포스팅CAMPAIGN_END: 캠페인 종료
검수 제출물 타입 (SubmissionItemType):
SCRIPT_VIDEO: 영상 대본 (1차 검수)SCRIPT_BLOG: 블로그 스크립트 (1차/2차 검수)VIDEO: 영상 (2차 검수)PHOTO: 사진 (2차 검수)CAPTION: 캡션 (2차 검수)HASHTAG: 해시태그 (2차 검수)
최종 제출물 타입 (FinalSubmissionType):
POST_URL: 게시물 URL
guideline (가이드라인 정보)
가이드라인이 없는 경우 null입니다. 가이드라인 구조에 대한 상세 내용은 가이드라인 조회 API를 참고하세요.
주요 필드:
contentTypes: 콘텐츠 타입 목록basicInfo: 기본 정보 (제품 링크, 콘텐츠 컨셉 등)contentDetailInfo: 촬영/콘텐츠 상세 (카테고리, 촬영 옵션 등)marketingInfo: 마케팅 정보 (소구 포인트, 해시태그, 브랜드 계정 태그, 협찬 레이블 등)detailPageInfo: 상세페이지 정보 (브랜드 로고, 썸네일, 상세 이미지)
schedules (캠페인 일정)
Prop
Type
phase (CampaignPhase) 값:
RECRUITMENT: 모집SELECTION: 선정FIRST_REVIEW: 1차 검수SECOND_REVIEW: 2차 검수POSTING: 포스팅CAMPAIGN_END: 캠페인 종료
에러 응답
캠페인을 찾을 수 없음 (404)
{
"status": 404,
"code": null,
"message": "캠페인을 찾을 수 없습니다. campaignNo: 1425",
"data": null
}