캠페인의 총 예산, 소요 크레딧, 환급 가능 금액을 조회합니다.

캠페인 예산 요약 조회

캠페인의 총 예산, 소요 크레딧(사용 금액), 환급 가능 금액, 잠금된 건수를 조회합니다.

기업 사용자와 관리자 모두 사용 가능한 API입니다.

HTTP 요청

GET /ai/payments/campaigns/{collabNo}/budget
Authorization: Bearer {access_token}

Path Parameters

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

응답

성공 응답 (200 OK)

{
  "status": 200,
  "code": null,
  "message": "캠페인 예산 조회 성공",
  "data": {
    "totalBudget": 1000000,
    "usedCredit": 300000,
    "refundAmount": 700000,
    "lockedCount": 5,
    "status": "ACTIVE"
  }
}

응답 필드 설명

필드	타입	설명
`totalBudget`	`Integer`	캠페인 총 예산 (크레딧 거래 내역에서 계산)
`usedCredit`	`Integer`	소요 크레딧 (현재 LOCKED 상태인 금액 합계)
`refundAmount`	`Integer`	환급 가능 금액 (totalBudget - usedCredit)
`lockedCount`	`Long`	예산이 잠긴 건수 (PROPOSAL된 크리에이터 수)
`status`	`String`	예산 상태 (기본값: "ACTIVE")

레거시 캠페인 응답 (200 OK)

SaaS 시작 이전 캠페인의 경우 예산 정보가 없습니다.

{
  "status": 200,
  "code": null,
  "message": "레거시 캠페인은 예산 정보가 없습니다.",
  "data": null
}

에러 응답

상태 코드	설명
`401`	인증 실패 (로그인 필요)
`404`	캠페인을 찾을 수 없음
`500`	서버 오류

사용 예시

cURL

curl -X GET "https://api.glowb.com/ai/payments/campaigns/12345/budget" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

JavaScript (fetch)

const response = await fetch(
  'https://api.glowb.com/ai/payments/campaigns/12345/budget',
  {
    method: 'GET',
    headers: {
      'Authorization': `Bearer ${accessToken}`,
      'Content-Type': 'application/json'
    }
  }
);

const result = await response.json();
console.log('예산 정보:', result.data);

주요 사용 사례

기업 대시보드: 캠페인별 예산 현황 표시
관리자 모니터링: 전체 캠페인 예산 관리
환급 처리: 캠페인 완료 시 환급 가능 금액 확인

참고 사항

예산 시스템은 SaaS 시작 캠페인(collab.saas.num 설정값) 이후에만 적용됩니다.
레거시 캠페인은 data: null을 반환합니다.
usedCredit은 실시간으로 계산되며, PROPOSAL 상태의 크리에이터들에게 할당된 금액의 합계입니다.

캠페인 예산 요약 조회

캠페인 예산 요약 조회

HTTP 요청

Path Parameters

응답

성공 응답 (200 OK)

응답 필드 설명

레거시 캠페인 응답 (200 OK)

에러 응답

사용 예시

cURL

JavaScript (fetch)

주요 사용 사례

관련 API

참고 사항

On this page