💳 청구 및 사용량 API
플랜 전환, 청구서 발행 및 리소스 소비. 네임스페이스 수준의 할당량 제한 및 사용량 추적.
- 카테고리: 플랫폼
- 복잡도: 보통
- 경로: 25 | 스키마: 101
- 티어: Standard
- 관련 도메인:
system,users
사용 사례
섹션 제목: “사용 사례”- 구독 플랜 및 청구 전환 관리
- 결제 방법 및 청구서 구성
- 네임스페이스 전반의 리소스 할당량 사용량 추적
- 사용량 제한 및 용량 모니터링
기본 리소스
섹션 제목: “기본 리소스”- subscription: 서비스 자격에 대한 구독
- quota: 사용량 제한을 위한 리소스 할당량
- usage_report: 소비 추적을 위한 사용량 보고서
엔드포인트
섹션 제목: “엔드포인트”| 메서드 | 경로 | 설명 |
|---|---|---|
| POST | /api/data/namespaces/system/billing/usage_summary | 청구 사용량 요약. |
| GET | /api/web/namespaces/{namespace}/usage/invoice_pdf | 청구서 PDF 가져오기. |
| GET | /api/web/namespaces/{namespace}/usage/invoices/custom_list | 청구서 목록 조회. |
| POST | /api/web/namespaces/{namespace}/billing/payment_method/{name}/primary | 신용카드를 기본으로 설정. |
| POST | /api/web/namespaces/{namespace}/billing/payment_method/{name}/secondary | 결제 방법을 보조로 설정. |
| POST | /api/web/namespaces/{namespace}/billing/payment_method/{name}/swap-primary | 결제 방법을 보조로 교체. |
| POST | /api/web/namespaces/{namespace}/billing/payment_methods | 결제 방법 사양 생성. |
| DELETE | /api/web/namespaces/{namespace}/billing/payment_methods/{name} | 지정된 결제 방법 삭제. |
| GET | /no_auth/namespaces/system/billing/plan_transition | 플랜 전환 가져오기. |
| POST | /api/web/namespaces/{namespace}/billing/plan_transition | 플랜 전환 시작. |
| POST | /api/web/namespaces/{metadata.namespace}/quotas | 할당량 생성. |
| PUT | /api/web/namespaces/{metadata.namespace}/quotas/{metadata.name} | 할당량 교체. |
| GET | /api/web/namespaces/{namespace}/quota/limits | 사용자 지정 할당량 제한 가져오기. |
| GET | /api/web/namespaces/{namespace}/quota/usage | 할당량 사용량 가져오기. |
| GET | /api/web/namespaces/{namespace}/quotas | 할당량 목록 조회. |
| GET | /api/web/namespaces/{namespace}/quotas/{name} | 할당량 가져오기 |
| DELETE | /api/web/namespaces/{namespace}/quotas/{name} | 할당량 삭제. |
| GET | /api/web/namespaces/{namespace}/subscriptions/custom_list | 구독 목록 조회. |
| POST | /api/web/namespaces/system/addon/subscribe | XC 애드온 서비스 구독. |
| POST | /api/web/namespaces/system/addon/unsubscribe | XC 애드온 서비스 구독 취소. |
| POST | /api/web/namespaces/{namespace}/current_usage | 현재 사용량 세부 정보 조회. |
| POST | /api/web/namespaces/{namespace}/hourly_usage_details | 시간별 사용량 세부 정보 조회. |
| POST | /api/web/namespaces/{namespace}/monthly_usage | 월별 사용량 세부 정보 조회. |
| POST | /api/web/namespaces/{namespace}/usage_details | 사용량 세부 정보 조회. |
| GET | /api/web/namespaces/system/usage_plans/current | 현재 사용량 플랜 가져오기. |
| GET | /api/web/namespaces/system/usage_plans/custom_list | 사용량 플랜 목록 조회. |