Glowb Dev Docs
Admin APIAdmin Business Pending Campaigns API

GET /tracking-campaigns — 운송장 미입력 캠페인

배송형 캠페인 중 SELECTED 신청자에게 운송장 번호가 입력되지 않은 캠페인을 조회합니다.

운송장 미입력 캠페인 목록

배송형(Collab.deliveryType = DELIVERY) 캠페인 중, SELECTED 신청자 가운데 운송장 번호가 비어있는(ApplicationDelivery.trackingNumber == null 또는 공백) 신청자가 1명 이상 있는 캠페인을 조회합니다.

배송형이 아닌 캠페인은 자동으로 제외됩니다. Collab.deliveryTypeNO_DELIVERY 또는 VISIT_REQUIRED 인 캠페인은 어떤 필터 파라미터를 줘도 응답에 포함되지 않습니다.

정렬: 캠페인 등록일(registeredAt) ASC. 오래 등록된 캠페인이 위로 올라옵니다.

HTTP 요청

GET /ai/admin/pending/tracking-campaigns
Authorization: Bearer {access_token}

Query Parameters

파라미터타입필수기본값설명
campaignNosint[]아니오활성 배송형 캠페인 전체multi 지원. CAMPAIGN_COMPLETED 단계는 자동 제외. 배송형 사전 필터 후 적용.
businessIdstring아니오특정 기업 캠페인만 조회
pageint아니오0Spring Pageable
sizeint아니오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 / campaignTitleInteger / string캠페인 식별자
businessId / businessNamestring / string?기업
managersarray캠페인 담당자 목록(N:M, 동등). 각 항목 { managerNo, name, email, phone, isDefault }. 미지정 시 빈 배열
registeredAtLocalDateTime?캠페인 등록일. 정렬 보조 키.
pendingCountint운송장 미입력 신청자 수
pendingApplicantsarray신청자 drill-down

pendingApplicants[]

필드타입설명
applicationIdLong신청 ID
influenceIdInteger인플루언서 ID
nicknamestring닉네임
deliveryStatusenumBEFORE_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

API 테스트

On this page