Admin APIAdmin Dashboard API
PATCH /ai/admin/dashboard/applications/creator-recruit
크리에이터 모집 단계 일괄 업데이트
크리에이터 모집 단계 일괄 업데이트
여러 캠페인 신청의 선정 상태, 배송 상태, 운송장 번호를 일괄 업데이트합니다.
업데이트 순서: 선정 상태 -> 배송 상태 -> 운송장 번호
선정 상태가 SELECTED로 변경되면 매칭/배송 테이블이 자동 생성됩니다.
제외(ELIMINATED) 시 예비(RESERVED) 자동 승계
선정 인원의 계약이 불발되어 ELIMINATED(제외)로 처리하면, 모집인원(Collab.person) 대비 빈자리만큼
예비(RESERVED)를 금액 높은순으로 자동 승계합니다 — 예비를 제안 상태로 전환하고 계약서를 발송합니다.
- 캠페인 예산이 부족한 예비는 건너뛰고 다음 금액순 예비로 넘어갑니다(기업 글로벌 크레딧은 사용하지 않음).
- 캠페인 결과 취합(
RESULT_SUMMARY) 단계부터는 승계하지 않으며, 이 단계 진입 시 남은 예비는 미선정(REJECTED)으로 정리됩니다. - 전원 서명이 완료되기 전까지 예비는 미선정 처리되지 않고 유지됩니다.
HTTP 요청
PATCH /ai/admin/dashboard/applications/creator-recruit
Authorization: Bearer {access_token}
Content-Type: application/jsonRequest Body
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
applicationId | Long | 예 | 캠페인 신청 ID |
selectionStatus | String | 아니오 | 선정 상태 |
deliveryStatus | String | 아니오 | 배송 상태 |
trackingNumber | String | 아니오 | 운송장 번호 |
courierCode | String | 아니오 | 택배사 코드. 지원 택배사는 kr.xxx(kr.cjlogistics 등), 기타는 OTHER |
customCourierName | String | 아니오 | 기타 택배사 자유입력명. courierCode가 kr.*가 아닐 때만 저장되며, 지원 택배사로 교체하면 null로 초기화됩니다 |
selectionStatus 값
| 값 | 설명 |
|---|---|
WAITING | 선정 대기 |
SELECTED | 선정 |
RESERVED | 예비 |
REJECTED | 미선정 |
ELIMINATED | 제외 |
deliveryStatus 값
| 값 | 설명 |
|---|---|
BEFORE_DELIVERY | 배송 전 |
DELIVERING | 배송 중 |
DELIVERED | 배송 완료 |
요청 예시
{
"items": [
{
"applicationId": 1,
"selectionStatus": "SELECTED",
"deliveryStatus": "DELIVERING",
"trackingNumber": "1234567890",
"courierCode": "OTHER",
"customCourierName": "천일택배"
},
{
"applicationId": 2,
"selectionStatus": "SELECTED",
"deliveryStatus": "DELIVERED"
},
{
"applicationId": 3,
"selectionStatus": "REJECTED"
}
]
}응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "3건의 항목이 업데이트되었습니다.",
"data": {
"success": true,
"updatedIds": [1, 2, 3],
"failedIds": [],
"message": "3건의 항목이 업데이트되었습니다."
}
}일부 실패 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "2건 성공, 1건 실패",
"data": {
"success": false,
"updatedIds": [1, 2],
"failedIds": [3],
"message": "2건 성공, 1건 실패"
}
}