Admin APIAdmin Dashboard API
PATCH /ai/admin/dashboard/{campaignNo}/substep
캠페인 진행 상태 변경
캠페인 진행 상태 변경
캠페인의 진행 상태(SubStep)를 관리자 권한으로 강제 변경합니다.
CREATOR_MATCHING 강제 전환 시 예산 경고
subStep=CREATOR_MATCHING으로 변경 시 예산 80% 미달이어도 강제 전환됩니다. 단, 응답에 budgetWarning: true와 budgetUsagePercentage가 포함되므로 휴먼에러 방지를 위해 확인 후 진행하세요.
HTTP 요청
PATCH /ai/admin/dashboard/{campaignNo}/substep?subStep={subStep}
Authorization: Bearer {access_token}Query Parameters
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
subStep | CampaignSubStep | 예 | 변경할 진행 상태 |
CampaignSubStep 값
| 값 | 설명 |
|---|---|
CAMPAIGN_REVIEW | 캠페인 내용 검토 |
CAMPAIGN_PAYMENT | 캠페인비 결제 |
CAMPAIGN_GUIDELINE | 콘텐츠 가이드라인 작성 |
CREATOR_RECRUIT | 크리에이터 모집 |
CREATOR_MATCHING | 협업 상세 협의 |
CONTENT_CREATION | 콘텐츠 제작 |
CONTENT_REVIEW | 콘텐츠 검수 |
CONTENT_PUBLISH | 콘텐츠 발행 취합 |
RESULT_SUMMARY | 캠페인 결과 취합 |
CAMPAIGN_COMPLETED | 캠페인 완료 |
응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "캠페인 진행 상태가 변경되었습니다.",
"data": {
"campaignNo": 123,
"previousSubStep": "CREATOR_RECRUIT",
"currentSubStep": "CREATOR_MATCHING",
"budgetWarning": true,
"budgetUsagePercentage": 65.0
}
}Response Body 스키마
| 필드명 | 타입 | 설명 |
|---|---|---|
campaignNo | long | 캠페인 번호 |
previousSubStep | string | 변경 전 단계 |
currentSubStep | string | 변경 후 단계 |
budgetWarning | boolean | 예산 80% 미달 경고 (CREATOR_MATCHING 전환 시에만 체크) |
budgetUsagePercentage | double | 현재 예산 사용률 (%) |