Admin APIAdmin Business Pending Campaigns API
GET /tracking-campaigns — 운송장 미입력 캠페인
배송형 캠페인 중 SELECTED 신청자에게 운송장 번호가 입력되지 않은 캠페인을 조회합니다.
운송장 미입력 캠페인 목록
배송형(Collab.deliveryType = DELIVERY) 캠페인 중, SELECTED 신청자 가운데 운송장 번호가 비어있는(ApplicationDelivery.trackingNumber == null 또는 공백) 신청자가 1명 이상 있는 캠페인을 조회합니다.
배송형이 아닌 캠페인은 자동으로 제외됩니다. Collab.deliveryType 이 NO_DELIVERY 또는 VISIT_REQUIRED 인 캠페인은 어떤 필터 파라미터를 줘도 응답에 포함되지 않습니다.
정렬: 캠페인 등록일(registeredAt) ASC. 오래 등록된 캠페인이 위로 올라옵니다.
HTTP 요청
GET /ai/admin/pending/tracking-campaigns
Authorization: Bearer {access_token}Query Parameters
| 파라미터 | 타입 | 필수 | 기본값 | 설명 |
|---|---|---|---|---|
campaignNos | int[] | 아니오 | 활성 배송형 캠페인 전체 | multi 지원. CAMPAIGN_COMPLETED 단계는 자동 제외. 배송형 사전 필터 후 적용. |
businessId | string | 아니오 | 특정 기업 캠페인만 조회 | |
page | int | 아니오 | 0 | Spring Pageable |
size | int | 아니오 | 20 |
응답
성공 응답 (200 OK)
{
"status": 200,
"code": null,
"message": "운송장 미입력 캠페인 조회 성공",
"data": {
"summary": {
"totalCampaigns": 5,
"totalApplicants": 18
},
"page": {
"number": 0,
"size": 20,
"totalElements": 5,
"totalPages": 1
},
"content": [
{
"campaignNo": 2310,
"campaignTitle": "배송형 캠페인 X",
"businessId": "biz-member-id",
"businessName": "X 브랜드",
"managers": [
{ "managerNo": 1, "name": "김매니저", "email": "kim@example.com", "phone": "010-9999-9999", "isDefault": true }
],
"registeredAt": "2026-03-30T09:00:00",
"pendingCount": 4,
"pendingApplicants": [
{
"applicationId": 9101,
"influenceId": 600,
"nickname": "creator-x",
"deliveryStatus": "BEFORE_DELIVERY"
},
{
"applicationId": 9102,
"influenceId": 601,
"nickname": "creator-y",
"deliveryStatus": "BEFORE_DELIVERY"
}
]
}
]
}
}응답 필드
캠페인 row
| 필드 | 타입 | 설명 |
|---|---|---|
campaignNo / campaignTitle | Integer / string | 캠페인 식별자 |
businessId / businessName | string / string? | 기업 |
managers | array | 캠페인 담당자 목록(N:M, 동등). 각 항목 { managerNo, name, email, phone, isDefault }. 미지정 시 빈 배열 |
registeredAt | LocalDateTime? | 캠페인 등록일. 정렬 보조 키. |
pendingCount | int | 운송장 미입력 신청자 수 |
pendingApplicants | array | 신청자 drill-down |
pendingApplicants[] 행
| 필드 | 타입 | 설명 |
|---|---|---|
applicationId | Long | 신청 ID |
influenceId | Integer | 인플루언서 ID |
nickname | string | 닉네임 |
deliveryStatus | enum | BEFORE_DELIVERY | SHIPPING | DELIVERED. 보통 BEFORE_DELIVERY 지만, 운송장은 비어있는데 상태가 다른 값으로 잘못 변경된 경우 식별용으로 사용 가능. ApplicationDelivery 자체가 없는 경우 기본값 BEFORE_DELIVERY 로 표기. |
summary
| 필드 | 설명 |
|---|---|
totalCampaigns | 운송장 미입력이 있는 캠페인 총 개수 |
totalApplicants | 모든 캠페인의 pendingCount 합 |
예시
활성 배송형 캠페인 전체에서 운송장 미입력 조회
GET /ai/admin/pending/tracking-campaigns특정 기업 한정
GET /ai/admin/pending/tracking-campaigns?businessId=biz-member-id