Admin API약기법 검수
사용 여부 변경
캠페인의 규정 검수 opt-in 여부를 켜거나 끕니다.
규정 검수 사용 여부 변경
캠페인의 규정 검수 opt-in 플래그를 켜거나 끕니다. 켜진 캠페인에서만 가이드라인 완성·제출물 제출·피드백 제출 시 규정 검수가 자동 실행됩니다.
MariaDB TB_COLLAB.regulation_review_enabled 에 저장됩니다. 캠페인만 존재하면 가이드라인 작성 전에도 미리 켜둘 수 있습니다.
이전에는 MongoDB guidelines 문서 필드였고 문서가 있어야만 설정이 가능했는데, 두 가지 문제로 옮겼습니다.
가이드라인 생성 전에는 토글 자체가 없어 준비 단계에서 켜둘 수 없었고, 가이드라인 문서 전체 저장과 겹치면
토글이 stale 값으로 되덮일 수 있었습니다.
HTTP 요청
PUT /ai/admin/regulation/{collabNo}/enabled
Authorization: Bearer {access_token}
Content-Type: application/json관리자(ROLE_ADMIN) 전용입니다.
Path Parameters
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
collabNo | Integer | 예 | 캠페인 번호 |
Query Parameters
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
policyKey | String | 아니오 | 변경할 정책. 미지정 시 yakkiho |
토글로 제어되는 정책만 변경할 수 있습니다. metaAds(인스타그램 캠페인)와 tiktokAds(틱톡 캠페인)는 캠페인 속성으로 자동 적용되는 정책이라 INVALID_DATA 로 거부됩니다. 조용히 무시하면 "껐다"고 믿는데 계속 실행되기 때문입니다.
Request Body
{
"enabled": true
}| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
enabled | Boolean | 예 | true = 사용, false = 미사용 |
응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "규정 검수를 사용합니다.",
"data": {
"collabNo": 2622,
"policyKey": "yakkiho",
"enabled": true
}
}에러 응답
검증 실패는 CrawlingExceptionEnum.INVALID_DATA 로 처리되며, 이 enum 은 HttpStatus.NOT_FOUND 에 매핑돼 있습니다(이 컨트롤러의 기존 관례). 바깥 HTTP 는 200 이고 응답 body 의 status 필드가 실제 결과이므로 body 를 확인하세요.
| 상태 코드 | 설명 |
|---|---|
404 | enabled(boolean) 누락 / 알 수 없는 policyKey / 토글로 제어하지 않는 정책(metaAds·tiktokAds) — 모두 INVALID_DATA |
404 | 캠페인 없음 (CAMPAIGN_NOT_FOUND) — 설정 미적용 |
401 | 인증 실패 또는 관리자 아님 |