SaaS API기업용 콘텐츠 검수
POST /ai/business/contents/final-submission/{applicationId}/re-request
최종제출물 재요청
최종제출물 재요청
크리에이터에게 최종제출물 항목과 상세 사유를 선택하여 재요청합니다.
재요청 특징
- 여러 번 재요청 가능 (새 재요청은 기존 재요청을 덮어씀)
- 크리에이터가 재제출하면 재요청 정보는 초기화됨
- 재요청 시 크리에이터에게 알리고 알림톡 + 이메일 발송 (CS #104)
HTTP 요청
POST /ai/business/contents/final-submission/{applicationId}/re-request
Authorization: Bearer {access_token}
Content-Type: application/jsonPath Parameters
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
applicationId | long | 예 | 캠페인 신청 ID |
Request Body
{
"items": [
{ "type": "CLEAN_FILE_NARRATION", "reason": "나레이션 소리가 포함되어 있습니다" },
{ "type": "OTHER", "reason": "클린본에 자막이 남아있습니다" },
{ "type": "BRAND_TAG_PERSON", "reason": "" }
]
}| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
items | array | 예 | 재요청 항목 목록 |
items[].type | string | 예 | 재요청 타입 (아래 목록 참고) |
items[].reason | string | 아니오 | 항목별 상세 사유 |
재요청 타입 (FinalSubmissionType)
제출한 제작물 탭 (SUBMISSION)
| 타입 | 설명 |
|---|---|
CONTENT_LINK_WRONG | 올바른 게시물 링크 제출 |
PARTNERSHIP_CODE_WRONG | 올바른 파트너십 광고코드 제출 |
CLEAN_FILE_NARRATION | 클린본 파일에 나레이션 포함해서 제출 |
CLEAN_FILE_REMOVE_EDIT | 클린본 파일을 자막, 편집효과 제거해서 제출 |
FINAL_FILE_UPDATE | 최종본 파일을 최종수정본으로 제출 |
FILE_1080P | 최종/클린본 파일을 1080P 이상으로 제출 |
OTHER | 기타 (reason 필드에 상세 사유 필수) |
게시 필수 포함 유형 탭 (POSTING_REQUIRED)
| 타입 | 설명 |
|---|---|
BRAND_TAG_PERSON | 브랜드 계정 태그 (사람 태그) 추가 |
BRAND_TAG_CAPTION | 브랜드 계정 태그 (캡션에 작성하여 태그) 추가 |
SPONSORED_LABEL | 협찬 레이블 추가 |
COLLABORATOR | 공동작업자 추가 |
AUTO_DM | 자동 DM |
REQUIRED_HASHTAG | 필수해시태그 수정 및 추가 |
두 탭의 항목을 함께 보낼 수 있습니다. SUBMISSION 항목이 있으면 제출물 이메일, POSTING_REQUIRED 항목이 있으면 포스팅 누락 이메일이 각각 발송됩니다.
응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "재요청이 등록되었습니다.",
"data": {
"id": 1,
"applicationId": 123,
"contentLink": "https://instagram.com/p/...",
"partnershipCode": "ABC123",
"cleanFilePath": null,
"finalFilePath": null,
"isSubmitted": true,
"submittedAt": "2024-01-15T10:30:00",
"requiredTypes": ["CONTENT_LINK_WRONG", "CLEAN_FILE_NARRATION"],
"hasReRequest": true,
"reRequestItems": [
{
"type": "CLEAN_FILE_NARRATION",
"displayName": "클린본 파일에 나레이션 포함해서 제출",
"reason": "나레이션 소리가 포함되어 있습니다"
},
{
"type": "OTHER",
"displayName": "기타",
"reason": "클린본에 자막이 남아있습니다"
}
],
"reRequestTypes": ["CLEAN_FILE_NARRATION", "OTHER"],
"reRequestedAt": "2024-01-20T14:00:00"
}
}Response 스키마 (재요청 관련 필드)
| 필드 | 타입 | 설명 |
|---|---|---|
hasReRequest | boolean | 재요청 존재 여부 |
reRequestItems | array | 재요청 항목 목록 |
reRequestItems[].type | string | 재요청 타입 코드 |
reRequestItems[].displayName | string | 재요청 타입 한글 이름 |
reRequestItems[].reason | string | 항목별 상세 사유 (nullable) |
reRequestTypes | array<string> | 재요청 타입 코드 목록 (레거시 호환) |
reRequestedAt | datetime | 재요청 일시 |