부족분 lock 정책 토글 (admin)

캠페인의 부족분 lock 정책(Collab.deficitLockPolicyEnabled)을 활성화/비활성화합니다. 비활성화 시 해당 캠페인의 기존 DEFICIT lock 행이 자동 삭제됩니다.

관리자 전용 API입니다.

개요

기본값은 활성(true)이며, 캠페인마다 admin이 정책을 끄거나 다시 켤 수 있습니다. 비활성화하면:

해당 캠페인의 DEFICIT row가 즉시 삭제됨
기업이 POST /api/campaigns/{collabNo}/budget/deficit-lock 호출 시 POLICY_DISABLED 에러 반환
NORMAL lock 변화에도 부족분 자동 재계산이 일어나지 않음

비활성화 → 활성화로 되돌리면 정책 플래그만 변경되며, 자동으로 DEFICIT row를 다시 만들지는 않습니다.

HTTP 요청

PATCH /ai/admin/campaigns/{collabNo}/deficit-lock-policy
Authorization: Bearer {admin_access_token}
Content-Type: application/json

Path Parameters

파라미터	타입	필수	설명
`collabNo`	`Integer`	예	캠페인 번호

Request Body

{
  "enabled": false
}

필드	타입	필수	설명
`enabled`	`Boolean`	예	`true`로 활성, `false`로 비활성

응답

성공 응답 (200 OK)

{
  "status": 200,
  "code": null,
  "message": "정책이 비활성화되었습니다.",
  "data": null
}

enabled=true 시 메시지는 정책이 활성화되었습니다..

에러 응답

상태 코드	설명
`400`	요청 본문 검증 실패 (`enabled` 누락)
`401`	인증 실패
`403`	관리자 권한 없음
`404`	캠페인을 찾을 수 없음

사용 예시

curl -X PATCH "https://api.glowb.com/ai/admin/campaigns/12345/deficit-lock-policy" \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

참고 사항

정책 비활성화는 캠페인의 80% 의무 자체를 면제하는 것입니다. 신중히 사용해야 합니다.
비활성화 시 기존 lock된 부족분이 풀려 캠페인 잔액에 포함되므로, 캠페인 종료 시 그만큼 환급됩니다.

부족분 lock 정책 토글