Main API
캠페인 지원 API
캠페인 지원자 관리 API
캠페인 지원 API
캠페인 지원자(희망자) 관리 API입니다.
Base URL: /ai/collab-applicants
인증 정보
| 항목 | 값 |
|---|---|
| 인증 필요 | 예 |
| 인증 방식 | JWT Bearer Token |
엔드포인트 목록
| 메서드 | 경로 | 설명 | 인증 |
|---|---|---|---|
POST | /ai/collab-applicants | 캠페인 지원 신청 | 필요 |
API 상세
캠페인 지원 신청
캠페인에 지원 신청을 합니다.
HTTP 요청
POST /ai/collab-applicants
Authorization: Bearer {access_token}
Content-Type: application/jsonRequest Body
{
"collabNo": 123,
"message": "지원 메시지",
"expectedPrice": 100000
}Request Body 스키마 (CollabApplicantRequestDto)
| 필드명 | 타입 | 필수 | 설명 |
|---|---|---|---|
collabNo | int | 예 | 캠페인 번호 |
message | string | 아니오 | 지원 메시지 |
expectedPrice | int | 아니오 | 희망 단가 |
응답
성공 응답 (201 Created)
{
"status": 201,
"code": null,
"message": "신청자가 저장되었습니다.",
"data": {
"id": 456,
"collabNo": 123,
"memberId": "influencer_001",
"status": "PENDING",
"appliedAt": "2024-01-15T10:00:00"
}
}Response 스키마 (CollabApplicantResponseDto)
| 필드명 | 타입 | 설명 |
|---|---|---|
id | long | 지원 ID |
collabNo | int | 캠페인 번호 |
memberId | string | 지원자 ID |
status | string | 지원 상태 |
appliedAt | string | 지원 일시 |
지원 상태
| 상태 | 설명 |
|---|---|
PENDING | 대기 중 |
SELECTED | 선정됨 |
REJECTED | 거절됨 |
WITHDRAWN | 철회됨 |