Admin API추가금
가이드라인 추가금 옵션 목록 조회
가이드라인에서 선택 가능한 추가금 항목 목록을 반환합니다.
가이드라인 추가금 옵션 목록 조회
가이드라인에서 선택 가능한 추가금 항목 목록을 반환합니다. 각 항목의 코드, 한글 라벨, value 타입(AMOUNT/PERCENT), 기본 값을 포함합니다.
추가금 항목은 AddonFeeType enum으로 관리되며, 가이드라인 외 출처(예: 검수 단계) 항목은 현재 응답에 포함되지 않습니다.
HTTP 요청
GET /ai/admin/addon-fee/options
Authorization: Bearer {access_token}응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "가이드라인 추가금 옵션 목록 조회 성공",
"data": [
{
"code": "BEFORE_AFTER",
"label": "비포&애프터 샷",
"valueType": "PERCENT",
"defaultValue": 10
},
{
"code": "PROCEDURE",
"label": "시술 관련 샷",
"valueType": "PERCENT",
"defaultValue": 150
},
{
"code": "OUTDOOR",
"label": "야외/방문 촬영",
"valueType": "PERCENT",
"defaultValue": 50
}
]
}응답 필드
| 필드 | 타입 | 설명 |
|---|---|---|
code | String | 추가금 항목 enum 코드 (저장 시 사용) |
label | String | 한글 라벨 (UI 표시용) |
valueType | String | AMOUNT(원) / PERCENT(%) |
defaultValue | Number | null | 기본 값. PERCENT면 % 값, AMOUNT면 원 단위 |
전체 항목 목록
| code | label | valueType | defaultValue |
|---|---|---|---|
BEFORE_AFTER | 비포&애프터 샷 | PERCENT | 10 |
PROCEDURE | 시술 관련 샷 | PERCENT | 150 |
OUTDOOR | 야외/방문 촬영 | PERCENT | 50 |
CHILD_USAGE | 아이가 제품을 사용하는 샷 | PERCENT | 50 |
BODY_EXPOSURE | 신체 노출이 되는 촬영 | PERCENT | 20 |
COLLABORATOR | 공동작업자 추가 | PERCENT | 20 |
PRODUCT_LINK_DM | 제품 링크 DM 공유 | PERCENT | 50 |
PRODUCT_LINK_PROFILE | 제품 링크 프로필 공유 | PERCENT | 30 |
PRODUCT_LINK_CAPTION | 제품 링크 캡션 공유 | PERCENT | 20 |
PRODUCT_LINK_COMMENT | 제품 링크 댓글 공유 | PERCENT | 20 |
NARRATION | 나레이션 | AMOUNT | 20000 |
EXTRA_SCENE | 기본 장면 수 초과 | PERCENT | 20 |
SCRIPT_REVIEW(대본 검수, AMOUNT 30000), PRODUCT_RETURN(제품 회수, AMOUNT 10000)은 캠페인 생성 단계에서 체크되는 옵션이라 가이드라인 옵션 응답에서 제외됩니다. 이들은 AddonFeeType enum 에는 존재하나 본 API 응답에서는 빠집니다.
기본 값(defaultValue)은 enum에 박혀있는 가이드라인 표준 값입니다. 캠페인별로 다른 값이 적용될 수 있으며, 그 경우 캠페인 추가금 저장 시점에 별도로 관리됩니다.
EXTRA_SCENE 은 다른 항목과 다르게 동적으로 계산됩니다.
defaultValue: 20은 "장면 한 개 초과당 단가 상승률(%)" 입니다 (다른 항목처럼 "켜면 +20%" 가 아님).- 30초 영상 기준 기본 장면 수는 7개(초반 2 + 중반 3 + 후반 2)이며, 가이드라인 V4 저장 시
shots의 장면 수가 7 을 넘으면 자동으로CampaignAddonFee에value = 20 × (총장면수 − 7)로 sync 됩니다. - 예: 총 9 장면이면
value = 40으로 저장. - 관리자가 수동으로 토글하는 항목이 아니라 가이드라인 저장 시 자동 적용/해제 됩니다 (장면 수 7개 이하로 떨어지면 row 자동 삭제).
에러 응답
| 상태 코드 | 설명 |
|---|---|
401 | 인증 실패 |
403 | ADMIN 권한 필요 |