비용 분석 API 레퍼런스

GIIP 플랫폼에서 집계된 클라우드 및 인프라 비용 데이터와 AI 최적화 제안을 조회하기 위한 API 상세 명세입니다.

📋 개요

비용 분석 API는 여러 클라우드(Azure, AWS 등)와 온프레미스 자원의 비용 데이터를 통합하여 제공합니다. 재무 시스템과의 연동이나 자동 리포트 생성을 위해 활용할 수 있습니다.

⚠️ 구현 상태 (먼저 확인) 아래의 범용 /cost/* 엔드포인트(/cost/summary, /cost/breakdown, /cost/recommendations, https://api.giip.io/v3, x-giip-ak 헤더)는 계획/미구현 상태입니다 — 아직 호출하지 마세요. Azure 비용은 실제 배포된 API azureCost / azureCostServers(https://giipfaw.azurewebsites.net/api, 인증 헤더 x-api-key)를 사용하세요. 복사·실행 가능한 퀵스타트는 Azure 비용 가이드의 "🤖 AI/API 퀵스타트" 절에 있습니다.

✅ 구현됨: Azure 비용 API (x-api-key)

API	Method	URL
서버 목록	GET	https://giipfaw.azurewebsites.net/api/azureCostServers?csn={csn}
비용 상세	GET	https://giipfaw.azurewebsites.net/api/azureCost?csn={csn}&lssn={lssn}

인증은 x-api-key 헤더로만 전달합니다(키를 URL·본문에 넣지 않음). 요청/응답 계약, 오류표, cURL/PowerShell/Python 예제는 Azure 비용 가이드에 있습니다.

🔍 주요 엔드포인트 (🚧 계획/미구현)

아래 세 엔드포인트는 계획 중인 범용 비용 API 로 아직 구현되지 않았습니다. 설계 참고용으로만 남겨 두며, 실제 조회는 위의 Azure 비용 API 를 사용하세요.

1. 일일/월일 비용 요약 조회 — 🚧 계획/미구현

특정 기간 동안 발생한 전체 비용의 합계를 가져옵니다.

• URL: GET /cost/summary
• 주요 파라미터:
  • date_from, date_to: 조회 기간 설정
  • prj_isn (Integer): 특정 프로젝트의 비용만 조회
• 응답 데이터: 총 금액, 통화(Currency), 전일 대비 변동률 등

2. 자산별 비용 비중 조회 — 🚧 계획/미구현

어떤 서버나 데이터베이스에서 가장 많은 비용이 발생하는지 분석합니다.

• URL: GET /cost/breakdown
• 응답 데이터: 자산 타입별(VM, DB, Network 등) 비용 리스트

3. AI 비용 최적화 제안 조회 — 🚧 계획/미구현

AI가 분석한 자원 조정(Rightsizing)을 통한 비용 절감 예상치를 조회합니다.

• URL: GET /cost/recommendations
• 응답 데이터: 대상 자산, 현재 사양, 추천 사양, 예상 절감액

🛠️ 활용 예시 (cURL) — Azure 비용 API (구현됨)

# 키를 URL/본문에 넣지 않고 환경변수만 사용
export GIIP_CSN=47
export GIIP_API_KEY=***your_key***

# 서버 목록 + 기본 서버
curl -s "https://giipfaw.azurewebsites.net/api/azureCostServers?csn=${GIIP_CSN}" \
     -H "x-api-key: ${GIIP_API_KEY}"

# 단일 서버 비용 상세
curl -s "https://giipfaw.azurewebsites.net/api/azureCost?csn=${GIIP_CSN}&lssn=71197" \
     -H "x-api-key: ${GIIP_API_KEY}"

🛡️ Sk3(고성능 로깅) 활용

비용 데이터 수집의 데이터 무결성 검증과 상세한 감사 로그가 필요한 경우 giipApiSk3 엔드포인트를 권장합니다.

• 엔드포인트: https://giipfaw.azurewebsites.net/api/giipApiSk3
• 특합 장점: 자동 에러 로깅, 호출자 메타데이터(IP 등) 추적, jsondata 치환 기능을 통한 복잡한 조회 조건 최적화.
• 활용 팁: 대규모 인프라 비용 분석 시 text 명령과 jsondata를 조합하여 쿼리 무결성을 보장하며 호출할 수 있습니다.

문제 해결

증상	원인	해결
401 인증 오류가 발생하거나 빈 응답이 반환됨	x-api-key 헤더가 없거나 잘못된 키가 입력됨	요청 헤더의 x-api-key 값에 유효한 키가 설정되었는지 확인합니다(Azure 비용 API는 x-giip-ak가 아니라 x-api-key를 사용)
응답의 RstVal이 200이 아닌 코드를 반환함	잘못된 파라미터 또는 조회 조건	API 결과 코드 가이드를 참조하여 원인 코드를 확인하고 파라미터를 교정합니다
Sk3의 text 명령 호출이 실패함	text 명령 시그니처가 잘못됨	text 명령과 jsondata의 조합 형식이 올바른지 확인합니다
jsondata 전달 시 JSON 파싱 오류가 발생함	jsondata 내 따옴표가 올바르게 이스케이프되지 않음	jsondata 값의 따옴표를 정확히 이스케이프하여 다시 전송합니다

---

버전: 1.1 최종 업데이트: 2026-04-10 소스 파일: giipv3/public/help/api-cost.ko.md

---

관련 문서:

• API 결과 코드 가이드 (RstVal)