SaaS API인플루언서 SaaS
GET /ai/influence/campaign/{collabId}/application/info
캠페인 신청 페이지 정보 조회
캠페인 신청 페이지 정보 조회
캠페인 신청 페이지 접속 시 필요한 정보를 조회합니다.
이미 신청한 캠페인이면 신청 시 제출한 값을 내려줍니다. 신청 전이면 프로필 기반 프리필값을
내려줍니다. 둘을 구분하려면 alreadyApplied 를 보세요.
HTTP 요청
GET /ai/influence/campaign/{collabId}/application/info
Authorization: Bearer {access_token}Path Parameters
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
collabId | long | 예 | 캠페인 ID |
응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "캠페인 신청 정보 조회 완료",
"data": {
"applicantName": "홍길동",
"email": "user@example.com",
"snsAccounts": [
{
"snsTypeId": 2,
"snsTypeName": "instagram",
"accountId": "influencer"
}
],
"deliveryAddress": {
"id": 999,
"addressName": "집",
"recipientName": "홍길동",
"recipientPhone": "01012345678",
"postalCode": "12345",
"baseAddress": "서울시 강남구 테헤란로 123",
"detailAddress": "101호",
"isDefault": true,
"createdAt": "2024-01-15T10:00:00",
"updatedAt": null
},
"useOAuthFlow": false,
"qoo10Account": "qoo10-id",
"alreadyApplied": true
}
}응답 필드
| 필드 | 타입 | 설명 |
|---|---|---|
applicantName / email | string | 신청자명 / 이메일. 신청 시 입력값이 프로필에 반영되므로 항상 프로필 값 |
snsAccounts | object[] | 해당 캠페인 SNS 타입에 맞는 계정. 없으면 빈 배열 |
snsAccounts[].snsTypeId | int | 1: 페이스북, 2: 인스타그램, 3: 유튜브, 4: 틱톡, 5: 네이버 |
snsAccounts[].snsTypeName | string | SNS 타입명 |
snsAccounts[].accountId | string | 계정 아이디(핸들). URL 이 아니라 @ 없는 핸들만 내려갑니다 |
deliveryAddress | object | null | 배송지. 등록된 배송지가 하나도 없으면 null |
useOAuthFlow | boolean | true 면 Instagram OAuth 버튼 표시, false 면 레거시 텍스트 입력 |
qoo10Account | string | null | Qoo10 계정. 신청 시 제출한 값. 신청 전이면 null |
alreadyApplied | boolean | 분기 키. true 면 위 값들은 신청 시 제출한 값, false 면 프로필 기반 프리필값 |
값의 출처
alreadyApplied 에 따라 같은 필드라도 출처가 달라집니다.
| 필드 | alreadyApplied: true (신청 완료) | alreadyApplied: false (신청 전) |
|---|---|---|
deliveryAddress | 신청에 매핑된 배송지 | 기본 배송지 → 없으면 등록된 것 중 하나 |
snsAccounts | 신청 시 제출한 계정 1건 | 연동 계정(Instagram OAuth) 또는 레거시 프로필 계정 |
qoo10Account | 신청 시 제출한 값 | null |
두 가지 예외가 있습니다.
- 신청에 배송지가 매핑되지 않은 경우(배송 없는 캠페인 등)에는
alreadyApplied: true여도deliveryAddress가 기본 배송지 프리필로 내려갑니다. - 관리자가 유저 풀에서 담아만 두고 아직 단가를 보내지 않은 행은 본인 신청으로 보지 않습니다.
이 경우
alreadyApplied는false이고 프리필값이 내려갑니다.