SaaS API피드백 관리자 승인 (v4)
검토 대기 목록
adminApprovalStatus가 PENDING 또는 CHANGES_REQUESTED인 모든 검수 라운드와 그 피드백들을 반환합니다.
검토 대기 목록
adminApprovalStatus가 PENDING 또는 CHANGES_REQUESTED인 모든 검수 라운드 + 그 피드백들을 한 번에 반환합니다.
ADMIN 권한 필요 (ROLE_ADMIN). 아니면 차단.
HTTP 요청
GET /ai/admin/feedback-approvals
Authorization: Bearer {access_token}응답
성공 응답 (200)
data는 ReviewSummary[] (상태 조회의 data와 동일 구조의 배열).
{
"status": 200, "code": null, "message": "조회 성공",
"data": [
{
"reviewId": 910, "collabNo": 1234, "reviewRound": 1,
"adminApprovalStatus": "PENDING",
"feedbacks": [
{
"feedbackId": 5001,
"itemId": 9001,
"feedback": "...",
"feedbackType": "GUIDELINE_UNREFLECTED",
"feedbackCategory": "영상 초반",
"feedbackItem": "HOOK",
"billingType": "FREE",
"paidScope": null,
"revisionNo": 1,
"adminDecision": "PENDING",
"businessResponse": "NONE"
}
],
"businessRequestType": "VIDEO_RESUBMIT",
"feedbackCount": 1
}
]
}응답 필드 설명
각 ReviewSummary 객체의 구조는 상태 조회 응답 필드 설명과 동일합니다.
기업 요청 종류 (businessRequestType)
검수의 검수 목록에서 "기업이 무엇을 요청했는지"를 나타냅니다. 새로 저장하는 값이 아니라, 아래 세 가지를 조합해 조회 시점에 판정합니다.
- 라운드 타입 — 제출물이 스크립트(대본)인지 영상인지
- 승인이냐 재제출이냐 — 기업이 검수 화면에서 고른 동작
- 피드백 유무 — 이 라운드의 정식 피드백 건수 (
feedbackCount)
한글 문구는 프론트에서 매핑합니다. 백엔드는 값만 내려줍니다.
| 값 | 화면 문구 |
|---|---|
SCRIPT_APPROVE_WITH_FEEDBACK | 영상제작요청 (피드백 있음) |
SCRIPT_APPROVE_NO_FEEDBACK | 영상제작요청 (피드백 없음) |
SCRIPT_RESUBMIT | 스크립트 재제출 요청 |
SCRIPT_RESUBMIT_NO_FEEDBACK | 스크립트 재제출 요청 (피드백 없음) — 비정상 |
VIDEO_APPROVE_WITH_FEEDBACK | 업로드 요청 (피드백 있음) |
VIDEO_APPROVE_NO_FEEDBACK | 업로드 요청 (피드백 없음) |
VIDEO_RESUBMIT | 영상 재제출 요청 |
VIDEO_RESUBMIT_NO_FEEDBACK | 영상 재제출 요청 (피드백 없음) — 비정상 |
*_RESUBMIT_NO_FEEDBACK 은 승인 전에 확인이 필요합니다.
기업이 피드백을 하나도 남기지 않고 재제출 요청을 보낸 상태입니다. 이대로 건별 승인/거절로 승인하면 크리에이터에게 재제출 요청 메일은 나가지만 본문에 담을 피드백이 없어, 무엇을 고쳐야 하는지 알 수 없는 채로 제출 마감만 당겨집니다. 기업에 피드백 작성을 요청하거나, 원래 의도가 승인이었는지 확인한 뒤 처리하세요.
기업의 검수 제출은 피드백 제출 한 경로로만 들어옵니다. 같은 API 를
approveWithFeedback 값만 바꿔 호출하는 구조라, 승인과 재제출 요청이 이 값으로 갈립니다.