Admin APIAdmin Campaign API
GET /ai/admin/campaigns/{campaignNo}/copy-sources
이전 캠페인 불러오기 목록 조회
이전 캠페인 불러오기 목록 조회
관리자 캠페인 작성·수정 화면의 이전 게시물 불러오기 선택 목록입니다. 현재 캠페인의 소유 기업 범위로 캠페인을 번호 내림차순으로 반환합니다. 소유 기업이 에이전시 본계정이면 소속 고객사의 캠페인도 포함합니다.
HTTP 요청
GET /ai/admin/campaigns/1667/copy-sources
Authorization: Bearer {admin_access_token}관리자(ROLE_ADMIN) 인증이 필요합니다. 기업 계정으로 로그인할 필요가 없습니다.
| Path Parameter | 타입 | 필수 | 설명 |
|---|---|---|---|
campaignNo | Long | 예 | 현재 작성·수정 중인 캠페인 번호 |
조회 조건
- 소유 기업 ID(
TB_COLLAB.id)는 서버가 현재 캠페인에서 조회합니다. 기업 ID를 별도 파라미터로 받지 않습니다. - 소유 기업이 **에이전시 본계정(
AGENCY)**이면 본계정과 같은 에이전시에 속한 모든 고객사(AGENCY_CLIENT)의 캠페인을 포함합니다. - 소유 기업이 일반 기업 또는 에이전시 고객사이면 해당 기업의 캠페인만 조회합니다. 고객사에서 본계정이나 다른 고객사로 범위를 확장하지 않습니다.
- 현재 캠페인은 제외합니다.
- 완료 캠페인, 대시보드 숨김 캠페인도 포함합니다.
- 가이드라인 작성 여부·완성 여부·버전, 레거시 여부에 따른 필터는 없습니다.
- 후보가 없거나 현재 캠페인에 소유 기업이 지정되지 않은 경우
data: []를 반환합니다.
기존 기업 대시보드 GET /ai/collab의 노출 정책과 Nest 어드민 목록 정책은 유지됩니다.
완성된 v4 이상 가이드라인을 고르는
가이드라인 불러오기 API와 용도가 다릅니다.
응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "이전 캠페인 목록 조회 성공",
"data": [
{
"no": "1650",
"businessId": "business123",
"title": "이전 체험단 캠페인",
"snsType": "INSTAGRAM",
"regiDate": "2026-08-28 10:00:00",
"legacy": false
}
]
}| 필드 | 타입 | 설명 |
|---|---|---|
no | String | 선택한 캠페인의 번호. 기존 불러오기 목록과 동일한 문자열 타입 |
businessId | String | 후보 캠페인의 소유 기업 회원 ID. 에이전시 본계정 조회에서는 하위 고객사 ID일 수 있음 |
title | String | 캠페인 제목 |
snsType | String | null | FACEBOOK, INSTAGRAM, YOUTUBE, TIKTOK, NAVER. 미지정 또는 알 수 없는 값은 null |
regiDate | String | null | 등록 일시 (yyyy-MM-dd HH:mm:ss) |
legacy | boolean | 레거시 캠페인 여부 |
에러 응답
| 상태 코드 | 코드 | 설명 |
|---|---|---|
401 | 인증 오류 | 인증 실패 |
403 | 권한 오류 | 관리자 외 역할의 요청 |
현재 캠페인이 없으면 공통 CustomException 응답 규약에 따라 **HTTP 200 + 본문 status: 404**를 반환합니다.
HTTP 상태만으로 성공을 판단하지 말고 본문의 status도 확인해야 합니다.
{
"status": 404,
"code": "CAMPAIGN_NOT_FOUND",
"message": "존재하지 않는 캠페인입니다.",
"data": null
}프론트엔드 연결
PreviousCampaignLoader에서 목록을 가져올 때 기존 기업 로그인 → GET /ai/collab 호출을
이 API의 관리자 토큰 호출로 교체합니다. 응답은 data 배열을 사용하며 정렬과 현재 캠페인 제외는 서버에서 처리합니다.
선택 이후에는 반환된 no로 기존 API를 호출합니다.
- 캠페인 상세 조회:
GET /ai/admin/campaigns/{no} - 캠페인 이미지 조회:
GET /ai/admin/campaigns/{no}/images
이 API는 목록만 조회하며 캠페인 데이터나 대시보드 설정을 변경하지 않습니다.