Apigee Edge 문서를 보고 있습니다.
Apigee X 문서로 이동하세요. info
소개
요금표 요금제에서는 개발자에게 각 거래에 대해 요금이 청구됩니다. 이 유형의 요금제의 경우 충전 모델 및 충전 모델의 가격과 같은 추가 세부정보를 제공해야 합니다.
선택적으로 API 패키지가 아닌 개별 제품에 대해 프리미엄 요금제를 지정할 수 있습니다. 제품별 요금제에 대해서만 이 작업을 실행할 수 있습니다.
반복 요금은 언제 청구되고 번들 요금제는 언제 재설정되나요?
요금제에는 반복 수수료와 API 번들 (볼륨 기반 요금제 및 번들 요금제)이 포함될 수 있으며, 이 두 가지 모두 수수료가 청구되고 번들 요금제가 0으로 재설정되는 특정 시간이 포함됩니다. 다음 표에서는 반복 요금이 청구되고 번들 수가 재설정되는 시점을 설명합니다. 개발자 앱이 특정 거래 한도에 도달하여 추가 API 호출이 차단된 경우 API 호출 수가 0으로 재설정되고 앱이 다시 호출을 시작할 수 있는 시간입니다.
| 요금제에 다음이 포함된 경우 | ...이 문제가 발생합니다. |
|---|---|
|
반복 수수료 및 번들 요금제 재설정은 매월 1일에 발생합니다 (기본값). 특정 날짜에 월별 반복을 설정하려면 관리 API를 사용하여 요금제를 만들고 |
|
반복 수수료 및 번들 요금제 재설정은 개발자의 요금제 시작일로부터 7일마다 발생합니다. |
|
반복 수수료 및 번들 요금제 재설정은 개발자의 요금제 시작일로부터 X일마다 발생합니다. |
|
번들 요금제는 요금 카드에 정의된 집계 기준에 따라 재설정됩니다. 예를 들어 개발자가 월 19일에 요금제를 시작하고 집계 기준이 1개월인 경우 번들 사용량이 매월 19일에 재설정됩니다. 월의 날짜는 항상 동일하지 않을 수 있습니다. 예를 들어 요금제가 12월 31일에 시작되면 2월에는 28일만 있으므로 윤년이 아닌 해의 2월에는 재설정 날짜가 28일이 됩니다. 이후에는 28일이 재설정일로 유지됩니다. |
UI를 사용하여 요금 카드 요금제 구성
아래에 설명된 대로 요금표 요금제를 구성합니다.
에지
요금표 요금제를 구성하려면 요금제를 만들거나 수정할 때 요금표 또는 요금표 및 수익 공유 요금제 유형을 선택하고 요금표 섹션에서 다음 요금 부과 모델 중 하나를 선택합니다.
| 충전 모델 | 설명 |
| 정액제 | 개발자에게 각 거래에 대해 고정 요율이 청구됩니다. |
| 볼륨 밴드 | 개발자에게는 거래량에 따라 변동 요율이 청구됩니다. |
| 번들 | 개발자에게 트랜잭션 번들당 정해진 금액이 선불로 청구됩니다. 번들을 완전히 사용했는지 여부와 관계없이 개발자에게 설정된 금액이 청구됩니다.
참고: 요금 카드 및 수익 공유를 선택한 경우에는 이 옵션을 사용할 수 없습니다. |
그런 다음 선택한 요금 청구 모델에 따라 다음 정보를 구성합니다.
| 충전 모델 | 필드 | 설명 |
| 전체 | 계산 빈도 | 거래량 (또는 맞춤 속성 관련 거래량)이 계산되는 기간입니다. 개월 수 (1~24개월)를 선택합니다. |
| 정액제 | 균일 운임 | 각 거래에 청구되는 요율입니다. 소수점 이하 최대 4자리까지 십진수를 입력하세요.
참고: API (UI 아님)를 사용하여 청구되는 요율에 지정할 수 있는 소수점 이하 자릿수를 구성할 수 있습니다. 자세한 내용은 요금제 요율의 소수점 이하 자릿수 구성하기를 참고하세요. 예를 들어 0.10을 입력하고 통화가 미국 달러인 경우 개발자에게 거래당 $0.10가 청구됩니다. 또는 거래에서 전송된 바이트 수와 같은 맞춤 속성을 기반으로 하는 경우 개발자에게 지정된 바이트 수 전송에 대해 $0.10가 청구됩니다. |
| 볼륨 밴드 | 볼륨 범위 | 거래(또는 고객 속성 기반) 볼륨의 하나 이상의 범위(각 범위는 '볼륨 대역')입니다(볼륨 대역별 청구 모델의 경우). 각 볼륨 대역에 요율을 할당할 수 있습니다. 요율은 해당 볼륨 범위의 모든 거래에 적용됩니다. 첫 번째 범위의 상한을 지정합니다 (예: 최대 1000, 하한은 0보다 큰 값으로 사전 설정됨).
+새로 만들기를 클릭하여 밴드를 추가합니다. 이 수준 이상의 모든 거래를 나타내려면 최종 구간의 상한을 비워 둡니다. 참고: API (UI 아님)를 사용하여 청구되는 요율에 지정할 수 있는 소수점 이하 자릿수를 구성할 수 있습니다. 자세한 내용은 요금제 요율의 소수점 이하 자릿수 구성하기를 참고하세요. 예를 들어 볼륨 범위 섹션에 두 개의 볼륨 범위 (>0~1000, 1000 이상)를 지정한 경우 >0~1000 볼륨 범위에 0.15를 입력하고 1000 이상 볼륨 범위에 0.10을 입력할 수 있습니다. 선택한 통화가 미국 달러인 경우 처음 1,000건의 거래에 대한 요율은 거래당 0.15달러이고 1,000건을 초과하는 거래에 대한 요율은 거래당 0.10달러입니다. |
| 번들 | API 번들 가격 | 번들의 트랜잭션 수 (또는 번들에서 전송된 총 바이트 수와 같은 맞춤 속성과 관련된 수)입니다. 각 번들에 가격을 할당할 수 있습니다. 가격은 전체 번들에 적용됩니다. 첫 번째 번들의 상한을 지정합니다 (예: 최대 1,000. 하한은 0보다 큰 값으로 사전 설정됨).
+새로 만들기를 클릭하여 번들을 추가합니다. 마지막 번들에서 무제한 거래에 대해 개발자에게 고정 금액을 청구하지 않으려면 마지막 번들의 상한을 지정해야 합니다. 참고: API (UI 아님)를 사용하여 청구되는 요율에 지정할 수 있는 소수점 이하 자릿수를 구성할 수 있습니다. 자세한 내용은 요금제 요율의 소수점 이하 자릿수 구성하기를 참고하세요. 예를 들어 번들 크기 섹션에 두 개의 번들 (0 초과 최대 1,000, 1,000 초과 최대 2,000)을 지정하는 경우 0 초과 최대 1,000 번들에 50을 입력하고 1,000 초과 최대 2,000 번들에 40을 입력할 수 있습니다. 선택한 통화가 미국 달러인 경우 첫 번째 번들의 가격은 50달러이고 두 번째 번들의 가격은 40달러입니다. 개발자는 번들 내에서 사용하는 거래 수와 관계없이 해당 번들 가격이 청구됩니다 (즉, 번들 내 첫 번째 거래가 완료되는 즉시 번들 가격이 청구됨). |
API 제품에 맞춤 속성을 정의한 경우 각 거래 내의 맞춤 속성을 기반으로 앱 개발자에게 청구하도록 맞춤 등급 매개변수를 구성할 수 있습니다. 예를 들어 각 거래에 대해 개발자에게 요금을 청구하는 요금제를 설정하는 경우 거래마다 다를 수 있는 백엔드에서 전송된 바이트 수와 같은 맞춤 속성을 기반으로 요금제의 요율을 설정할 수 있습니다.
이 경우 맞춤 등급 매개변수 사용을 선택하고 드롭다운 목록에서 맞춤 속성을 선택합니다. 자세한 내용은 맞춤 속성으로 요금제 구성을 참고하세요.
클래식 에지 (프라이빗 클라우드)
기본 Edge UI를 사용하여 요금표 요금제를 구성하려면 다음 단계를 따르세요.
- 단계를 따라 요금제를 만듭니다.
- 요금제 유형 드롭다운에서 요금표를 선택하여 수익 모델을 구성합니다.
- 선택한 API 패키지에 여러 API 제품이 포함된 경우 다음 옵션 중 하나를 선택합니다.
참고: API 패키지에 API 제품이 하나만 포함된 경우 이 단계를 건너뛸 수 있습니다.
- 제품별 요금제를 사용하여 각 API 제품의 요금제 세부정보를 개별적으로 구성합니다.
- 모든 제품의 일반 요금제를 사용하여 모든 API 제품의 요금제 세부정보를 구성합니다.
- 일반 요금제 또는 각 API 제품별 요금제의 요금표를 클릭합니다.
참고: API 제품별 요금제를 구성할 때는 각 API 제품에 대해 개별적으로 요금표 요금제를 구성해야 합니다.
요금표 창이 열립니다.
- API 제품의 프리미엄 요금제를 설정합니다. 무료 체험 요금제는 개발자에게 일정 기간 동안 또는 사용량에 따라 API 제품을 무료로 사용할 수 있도록 제공합니다.
다음 정보를 입력합니다.
필드 설명 부분 유료 제품인가요? 무료 기간의 범위입니다. 다음 라디오 버튼 중 하나를 선택합니다.
- 수량별 무료 기간은 볼륨 필드에 지정된 수량을 기준으로 합니다.
- 기간별 수수료 기간은 Freemium Duration(무료 기간) 필드에 지정된 시간 간격을 기반으로 합니다.
- 먼저 도달하는 한도가 적용됩니다. 무료 기간은 '볼륨' 필드의 수량 또는 '무료 기간' 필드의 시간 간격에 도달하면 종료됩니다(둘 중 먼저 도달하는 시점).
- 아니요. 프리미엄 무료 체험 요금제가 아닙니다. 이는 기본값입니다.
Freemium 볼륨 개발자에게 청구되지 않는 거래량 (또는 거래 기록 정책에 기록된 맞춤 속성과 관련된 거래량)입니다. 볼륨은 API 제품에 대해 측정됩니다. 볼륨 번호(예: 5000)를 입력합니다. 즉, 개발자가 요금제를 시작하면 첫 5,000건의 거래(또는 맞춤 속성 관련 항목의 첫 5,000건의 사용)에 대한 요금이 청구되지 않습니다. 이 필드는 '무료 체험판 제품인가요?' 필드에서 '수량별' 또는 '둘 중 먼저 도달하는 항목'을 선택한 경우에만 사용 설정됩니다.
Freemium 기간 개발자에게 요금이 청구되지 않는 시간 간격입니다. 숫자를 입력하고 기간(예: 1개월)을 선택합니다. 즉, 개발자에게 1개월 동안 요금이 청구되지 않습니다. 이 필드는 '프리미엄 제품인가요?' 필드에서 '기간별' 또는 '둘 중 먼저 도달하는 항목'을 선택한 경우에만 사용 설정됩니다.
- 다음 요금 모델 중 하나를 선택합니다.
- 정액제 이 모델에서는 개발자에게 각 트랜잭션에 대해 고정 요율이 청구됩니다.
- 볼륨이 대역으로 지정되었습니다. 이 모델에서는 거래량에 따라 변동 요율이 개발자에게 청구됩니다.
- 번들 이 모델에서는 개발자에게 트랜잭션 번들마다 설정된 금액 (선불)이 청구됩니다. 번들이 완전히 사용되었는지 여부와 관계없이 개발자에게 설정된 금액이 청구됩니다.
고정 요금 모델: 일반 요금표 창의 가격 책정 섹션에 다음 정보를 입력합니다.
필드 설명 운영자 (또는 조직) 조직 이름입니다. 이 필드는 조직 프로필의 운영자 (또는 조직) 필드 값을 사용하여 미리 설정됩니다.
국가 조직의 운영 국가입니다. 이 필드는 조직 프로필의 국가 필드 값을 사용하여 미리 설정됩니다.
정액제 각 거래에 청구되는 요율입니다. 소수점 이하 최대 4자리까지의 십진수를 입력하세요.
참고: API (UI 아님)를 사용하여 청구되는 요율에 지정할 수 있는 소수점 이하 자릿수를 구성할 수 있습니다. 자세한 내용은 요금제 요율의 소수점 이하 자릿수 구성하기를 참고하세요.
예를 들어 0.10을 입력하고 통화가 미국 달러인 경우 개발자에게 각 거래에 대해 $0.10가 청구됩니다 (또는 거래에서 전송된 바이트 수와 같은 맞춤 속성을 기반으로 하는 경우 개발자에게 지정된 바이트 수 전송에 대해 $0.10가 청구됨).
볼륨 구간 모델의 경우: 일반 요금 카드 창에 집계 기준을 지정하고 '볼륨 구간'을 지정하는 데 사용하는 추가 필드가 표시됩니다. 볼륨 구간은 서로 다른 요금을 적용할 수 있는 거래량 범위입니다.
이 유형의 요금제는 일반적으로 개발자가 더 높은 볼륨 대역에 대해 할인된 요금을 제공하여 더 높은 볼륨을 생성하도록 유도하기 위해 설정됩니다.
일반 요금 카드 창에 다음 정보를 입력합니다.
필드 설명 집계 기준 거래량 (또는 맞춤 속성 관련 볼륨)이 집계되는 기간입니다. 집계된 거래량은 거래량 구간과 각 거래에 적용할 요율을 식별하는 데 사용됩니다. 개월 수(1~12개월)를 선택합니다.
번들이 재설정되는 시점에 대한 자세한 내용은 정기 결제 요금은 언제 청구되고 번들 요금제는 언제 재설정되나요?를 참고하세요.
볼륨 범위 하나 이상의 거래(또는 고객 속성 기반) 볼륨 범위입니다. 각 범위는 '볼륨 대역'입니다. 각 볼륨 범위에는 요율이 할당될 수 있습니다 (요율은 가격 책정 섹션의 볼륨 범위 필드에서 설정). 요율은 해당 볼륨 범위의 모든 거래에 적용됩니다. 첫 번째 범위의 상한을 지정합니다 (예: 최대 1000). 하한은 0보다 큰 값으로 사전 설정됩니다. +를 클릭하여 1000 초과 2000 이하와 같은 두 번째 범위를 추가합니다. +를 클릭하여 밴드를 추가합니다. 이 수준 이상의 모든 거래를 나타내려면 최종 구간의 상한을 비워 두면 됩니다.
가격 책정 운영자 (또는 조직) 조직 이름입니다. 이 필드는 조직 프로필의 운영자 (또는 조직) 필드 값을 사용하여 사전 설정됩니다.
국가 조직의 운영 국가입니다. 이 필드는 조직 프로필의 국가 필드 값을 사용하여 사전 설정됩니다.
통화 조직에서 사용하는 '기본' 또는 회계 통화입니다. 이 필드는 조직 프로필의 통화 필드 값을 사용하여 사전 설정되지만 여기에서 변경할 수 있습니다.
볼륨 범위 볼륨 구간의 요율입니다. 각 볼륨 대역의 요금을 지정합니다. 각 대역에 대해 소수점 이하 최대 4자리까지의 십진수를 입력합니다.
참고: API (UI 아님)를 사용하여 볼륨 대역 요율에 지정할 수 있는 소수점 이하 자릿수를 구성할 수 있습니다. 자세한 내용은 요금제 요율의 소수점 이하 자릿수 구성하기를 참고하세요.
예를 들어 볼륨 범위 섹션에 두 개의 볼륨 범위를 지정하는 경우(>0~1000, 1000 이상) >0~1000 볼륨 범위에 0.15를 입력하고 1000 이상 볼륨 범위에 0.10을 입력할 수 있습니다. 선택한 통화가 미국 달러인 경우 처음 1,000건의 거래에 대한 요율은 거래당 0.15달러이고 1,000건을 초과하는 거래에 대한 요율은 거래당 0.10달러입니다.
번들 모델의 경우: 일반 요금 카드 창에는 집계 기준 (개발자가 거래 번들을 사용할 수 있는 기간)을 지정하고 번들 크기와 같은 번들 관련 정보를 지정하는 데 사용하는 추가 필드가 표시됩니다.
일반 요금 카드 창에 다음 정보를 입력합니다.
필드 설명 집계 기준 개발자가 거래 번들을 사용하거나 맞춤 속성 기반 번들을 사용할 수 있는 기간입니다. 개월 수 (1~12개월)를 선택합니다. 이 기간이 지나면 요금제가 만료되며 개발자는 요금제 (및 번들)를 다시 구매해야 합니다.
번들이 재설정되는 시점에 대한 자세한 내용은 정기 결제 요금은 언제 청구되고 번들 요금제는 언제 재설정되나요?를 참고하세요.
번들 크기 번들의 거래 수 (또는 번들에서 전송된 총 바이트 수와 같은 맞춤 속성과 관련된 수)입니다. 각 번들에 가격을 할당할 수 있습니다 (가격 섹션의 번들 크기 필드에서 이 가격을 설정함). 가격은 전체 번들에 적용됩니다. 첫 번째 번들의 상한을 지정합니다 (예: 최대 1, 000, 하한은 0보다 큰 값으로 사전 설정됨). +를 클릭하여 두 번째 번들(예: 1, 000 초과 2, 000 이하)을 추가합니다. +를 클릭하여 번들을 추가합니다. 마지막 번들에서 무제한 거래에 대해 개발자에게 고정 금액을 청구하지 않으려면 마지막 번들의 상한을 지정해야 합니다.
가격 책정 운영자 (또는 조직) 조직 이름입니다. 이 필드는 조직 프로필의 운영자 (또는 조직) 필드 값을 사용하여 사전 설정됩니다.
국가 조직의 운영 국가입니다. 이 필드는 조직 프로필의 국가 필드 값을 사용하여 사전 설정됩니다.
통화 조직에서 사용하는 '기본' 또는 회계 통화입니다. 이 필드는 조직 프로필의 통화 필드 값을 사용하여 사전 설정되지만 여기에서 변경할 수 있습니다.
번들 크기 (가격) 번들의 가격입니다. 각 번들의 가격을 지정합니다. 소수점 이하 최대 4자리까지의 소수를 입력하세요.
참고: API (UI 아님)를 사용하여 번들 요율에 지정할 수 있는 소수점 이하 자릿수를 구성할 수 있습니다. 자세한 내용은 요금제 요율의 소수점 이하 자릿수 구성하기를 참고하세요.
예를 들어 번들 크기 섹션에 두 개의 번들 (0 초과 최대 1,000, 1,000 초과 최대 2,000)을 지정하는 경우 0 초과 최대 1,000 번들에 50을 입력하고 1,000 초과 최대 2,000 번들에 40을 입력할 수 있습니다. 선택한 통화가 미국 달러인 경우 첫 번째 번들의 가격은 50달러이고 두 번째 번들의 가격은 40달러입니다. 개발자는 번들 내에서 사용한 거래 수와 관계없이 해당 번들 가격이 청구됩니다 (즉, 번들 내 첫 번째 거래가 완료되는 즉시 개발자에게 번들 가격이 청구됨).
- 적용 후 닫기를 클릭하여 요금표 세부정보를 저장하고 표준 요금제 창으로 돌아갑니다.
- API 제품별 요금제의 경우 필요에 따라 추가 API 제품의 요금제 세부정보를 구성합니다.
API를 사용하여 요금 카드 요금제 구성
다음 섹션에 설명된 대로 API를 사용하여 요금표 요금제 세부정보를 구성합니다.
API를 사용하여 요금 카드 요금제 세부정보 지정
요금제를 만들 때 요금표 요금제 세부정보를 지정합니다. /organizations/{org_name}/monetization-packages/{package_id}/rate-plans 호출 시 요청 본문의 ratePlanDetails 속성에 세부정보를 지정합니다. ratePlanDetails 속성에 지정하는 내용은 선택한 요금 모델(고정 요금, 볼륨 구간, 번들)에 따라 달라집니다.
고정 요금 청구 모델 지정
고정 요금 청구 모델을 구현하려면 요금제 세부정보에 다음을 지정합니다.
- 요금제가 거래(
VOLUME)를 기반으로 하는지 아니면 맞춤 속성 (예:MINT_CUSTOM_ATTRIBUTE_1)을 기반으로 하는지를 나타내는 요금 매개변수입니다.VOLUME이 기본값입니다. - 요금이 단위당 고정되어 있음을 나타내는 요금 유형 (
UNIT)(즉, 볼륨 구간 또는 번들 요금 모델의 경우와 같이 거래량에 기반하지 않음) - 결제 기한 (예: 30일)입니다.
- 조직의 ID입니다.
- 회사가 사용하는 '기본' 또는 회계 통화입니다.
- 요금 계산 방식에 관한 세부정보를 제공하는 요금제 요금입니다. 청구 모델이 고정 요율을 기반으로 하므로 요금제 요율을 하나만 지정합니다.
요금제 요금에서 다음을 지정합니다.
- 요금제 요금의 유형 (
RATECARD)입니다. - 요금제의 요금입니다. 예를 들어 0.10을 지정하고 통화가 미국 달러인 경우 개발자에게 거래당 0.10달러가 청구됩니다 (또는 거래에서 전송된 바이트 수와 같은 맞춤 속성을 기반으로 하는 경우 지정된 바이트 수를 전송하는 데 개발자에게 0.10달러가 청구됨).
- 요율 적용의 시작 단위 (
0)입니다. 즉, 첫 번째 거래부터 각 거래에 요율이 적용됩니다.
요금제 세부정보 옵션의 전체 목록은 요금제 세부정보 구성 설정을 참고하세요.
예를 들어 다음은 고정 요금 모델을 사용하여 요금표 요금제를 만듭니다. 요율은 거래당 $0.10로 설정됩니다. 결제 기한은 30일입니다. (요율표 관련 세부정보가 강조 표시되어 있습니다.)
curl -H "Content-Type:application/json" -X POST -d \
'{
"name": "Flat rate card plan",
"developer":null,
"developerCategory":null,
"advance": "false",
"currency": {
"id" : "usd"
},
"description": "Flat rate card plan",
"displayName" : "Flat rate card plan",
"frequencyDuration": "30",
"frequencyDurationType": "DAY",
"earlyTerminationFee": "10",
"monetizationPackage": {
"id": "location"
},
"organization": {
"id": "{org_name}"
},
"paymentDueDays": "30",
"prorate": "false",
"published": "true",
"ratePlanDetails": [
{
"currency": {
"id" : "usd"
},
"paymentDueDays": "30",
"meteringType": "UNIT",
"organization": {
"id": "{org_name}"
},
"ratePlanRates": [
{
"type": "RATECARD",
"rate": "0.10",
"startUnit": "0"
}
],
"ratingParameter": "VOLUME",
"type": "RATECARD"
}],
"recurringStartUnit": 1,
"recurringType": "CALENDAR",
"recurringFee": "10",
"setUpFee": "10",
"startDate": "2013-09-15 00:00:00",
"type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password
볼륨 대역 충전 모델 지정
볼륨 구간 모델에서는 하나 이상의 요금제 요율이 포함된 요금제 세부정보를 지정합니다. 각 요율은 '볼륨 구간', 즉 거래량 범위 (또는 전송된 바이트 수와 같은 맞춤 속성을 기반으로 하는 범위)에 적용됩니다. 이 유형의 요금제는 일반적으로 개발자가 더 높은 볼륨 대역에 대해 할인된 요금을 제공하여 더 높은 볼륨을 생성하도록 유도하기 위해 설정됩니다.
요금제 요금 외에도 요금제 세부정보에 다음을 지정합니다.
- 요금제가 거래(
VOLUME)를 기반으로 하는지 아니면 맞춤 속성 (예:CUSTOM_ATTRIBUTE_1)을 기반으로 하는지를 나타내는 요금 매개변수입니다.VOLUME이 기본값입니다. - 요율이 거래량에 기반함을 나타내는 계량 유형 (
VOLUME)(즉, 정액제 요금 모델의 경우와 같이 거래당 정액제가 아님) - 결제 기한 (예: 30일)입니다.
- 조직의 ID입니다.
- 회사가 사용하는 '기본' 또는 회계 통화입니다.
- 거래량 (또는 맞춤 속성 관련 거래량)이 집계되는 기간을 함께 지정하는 기간 및 기간 유형입니다. 이를 '집계 기준'이라고도 합니다. 거래량은 집계 기준 (예: 1개월)에 따라 집계되어 적용 가능한 거래량 구간을 결정합니다.
- 적용 가능한 볼륨 대역을 결정하는 데 사용되는 집계 카운터입니다.
각 요금제 요금에 대해 다음을 지정합니다.
- 요금제 요금의 유형 (
RATECARD)입니다. - 요금제의 요금입니다. 예를 들어 0.10을 지정하고 통화가 미국 달러인 경우 개발자에게 각 거래당 $0.15가 청구됩니다 (또는 거래에서 전송된 바이트 수와 같은 맞춤 속성을 기반으로 하는 경우 개발자에게 지정된 바이트 수 전송에 대해 $0.15가 청구됨).
- 볼륨 대역의 시작 및 종료 단위입니다. 시작 단위는 볼륨 대역의 하한을 지정하고 종료 단위는 볼륨 대역의 상한을 지정합니다. 예를 들어 시작 단위를 0으로 지정하고 종료 단위를 1000으로 지정하면 집계 기간에 최대 1,000건의 거래가 볼륨 대역에 포함됩니다. 통화가 미국 달러이고 집계 기간이 1개월이며 처음 1, 000건의 거래에 대한 요율이 0.15인 경우 개발자에게는 해당 월에 최대 1, 000건의 거래에 대해 거래당 0.15달러가 청구됩니다.
번들이 재설정되는 시점에 관한 자세한 내용은 반복 요금은 언제 청구되고 번들 요금제는 언제 재설정되나요?를 참고하세요.
최종 볼륨 구간의 종료 단위를 지정하지 않으면 거래 수가 해당 구간의 시작 단위를 초과한 후의 모든 거래에 해당 구간의 요율이 적용됩니다. 예를 들어 마지막 구간의 시작 단위가 1000이고 해당 구간의 종료 단위를 지정하지 않으면 집계 기간에 1,000건의 거래가 발생한 후 모든 거래에 해당 구간의 요율이 적용됩니다.
요금제 세부정보 옵션의 전체 목록은 요금제 세부정보 구성 설정을 참고하세요.
예를 들어 다음은 볼륨 구간별 요금 모델을 사용하여 요금 카드 요금제를 만듭니다. 요금은 처음 1,000건의 거래에 대해 $0.15, 1,000건을 초과하는 모든 거래에 대해 $0.10로 설정됩니다. 집계 기준은 1개월입니다. 결제 기한은 30일입니다. (요율표 세부정보가 강조 표시되어 있습니다.)
curl -H "Content-Type:application/json" -X POST -d \
'{
"name": "Volume banded rate card plan",
"developer":null,
"developerCategory":null,
"currency": {
"id" : "usd"
},
"frequencyDuration": "30",
"description": "Volume banded rate card plan",
"displayName" : "Volume banded rate card plan",
"frequencyDuration": "30",
"frequencyDurationType": "DAY",
"earlyTerminationFee": "10",
"monetizationPackage": {
"id": "location"
},
"organization": {
"id": "{org_name}"
},
"paymentDueDays": "30",
"prorate": "false",
"published": "true",
"ratePlanDetails": [
{
"currency": {
"id" : "usd"
},
"aggregateStandardCounters": true,
"paymentDueDays": "30",
"duration": "1",
"durationType": "MONTH",
"meteringType": "VOLUME",
"organization": {
"id": "{org_name}"
},
"ratePlanRates": [
{
"type": "RATECARD",
"rate": "0.15",
"startUnit": "0",
"endUnit": "1000"
},
{
"type": "RATECARD",
"rate": "0.10",
"startUnit": "1000"
}
],
"ratingParameter": "VOLUME",
"type": "RATECARD"
}],
"recurringStartUnit": 1,
"recurringType": "CALENDAR",
"recurringFee": "10",
"setUpFee": "10",
"startDate": "2013-09-15 00:00:00",
"type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password
번들 충전 모델 지정
번들 요금 모델에서 개발자는 거래 '번들'(또는 전송된 바이트 수와 같은 맞춤 속성을 기반으로 하는 번들)에 대해 (선불로) 지불합니다. 각 번들의 요금과 집계 기준(즉, 개발자가 번들을 사용할 수 있는 기간)을 지정합니다.
예를 들어 첫 번째 번들 크기가 1~1, 000건의 거래이고 두 번째 번들 크기가 1, 001~2, 000건의 거래인 두 개의 번들을 설정한다고 가정해 보겠습니다. 첫 번째 번들의 요금은 50달러, 두 번째 번들의 요금은 40달러이며 집계 기준은 1입니다. 개발자가 첫 번째 번들에 대한 요금표 요금제를 구매하면 한 달에 1, 000건의 거래에 대해 50달러 (선불)를 지불합니다. 번들을 완전히 사용했는지 여부와 관계없이 개발자에게 설정된 금액이 청구됩니다. 집계 기간이 종료되면 요금제가 만료됩니다. 개발자가 번들을 다시 사용하려면 요금제 (및 번들)를 다시 구매해야 합니다.
요금제 세부정보에 지정하는 내용은 볼륨 구간별 요금 모델의 요금제 세부정보에 지정하는 내용과 기본적으로 동일합니다. 차이는 다음과 같습니다.
- 지정한 각 요금제는 볼륨 대역이 아닌 번들용입니다.
- 마지막 번들에서 무제한 거래에 대해 개발자에게 고정 금액을 청구하지 않으려면 마지막 번들의 상한을 지정해야 합니다.
요금제 세부정보 옵션의 전체 목록은 요금제 세부정보 구성 설정을 참고하세요.
예를 들어 다음은 번들 요금 모델을 사용하여 요금 카드 요금제를 만듭니다. 요금은 첫 번째 번들 (최대 1,000건의 거래)에 50달러, 두 번째 번들 (1,000건 초과, 최대 2,000건의 거래)에 40달러로 설정됩니다. 집계 기준은 1개월입니다. 결제 기한은 30일입니다.
curl -H "Content-Type:application/json" -X POST -d \
'{
"name": "Bundled rate plan",
"developer":null,
"developerCategory":null,
"currency": {
"id" : "usd"
},
"frequencyDuration": "30",
"description": "Bundled rate plan",
"displayName" : "Bundled rate plan",
"frequencyDurationType": "DAY",
"earlyTerminationFee": "10",
"monetizationPackage": {
"id": "location"
},
"organization": {
"id": "{org_name}"
},
"paymentDueDays": "30",
"prorate": "true",
"published": "true",
"ratePlanDetails": [
{
"currency": {
"id" : "usd"
},
"aggregateStandardCounters": true,
"paymentDueDays": "30",
"duration": "1",
"durationType": "MONTH",
"meteringType": "STAIR_STEP",
"organization": {
"id": "{org_name}"
},
"ratePlanRates": [
{
"type": "RATECARD",
"rate": "50",
"startUnit": "0",
"endUnit": "1000"
},
{
"type": "RATECARD",
"rate": "40",
"startUnit": "1000",
"endUnit": "2000"
}
],
"ratingParameter": "VOLUME",
"type": "RATECARD"
}],
"recurringStartUnit": 1,
"recurringType": "CALENDAR",
"recurringFee": "10",
"setUpFee": "10",
"startDate": "2013-09-15 00:00:00",
"type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password
API를 사용하여 개별 제품의 무료 체험 요금제 지정
요금표 요금제에서는 API 패키지가 아닌 개별 제품에 대해 무료 체험 요금제를 설정할 수 있습니다. 프리미엄 요금제는 개발자에게 일정 기간 동안 또는 사용량에 따라 API 제품을 무료로 사용할 수 있도록 제공합니다.
API 제품의 프리미엄 요금제를 설정할 때 요금표 요금제 세부정보에서 개발자가 API 제품에서 제공하는 리소스를 무료로 사용할 수 있는 기간을 지정합니다. 기간은 다음 중 하나를 기반으로 할 수 있습니다.
- 기간, 즉 시행일과 종료일 사이의 시간입니다.
- API 제품과 관련된 거래 수 또는 거래 기록 정책에 기록된 맞춤 속성과 관련된 볼륨과 같은 수량입니다.
무료 기간이 수량을 기반으로 하는 경우 무료 단위 수로 지정합니다. 예를 들어 다음은 5, 000단위의 볼륨을 기반으로 한 무료 체험 요금제가 포함된 요금표 요금제를 만듭니다 (무료 체험 관련 사양이 강조 표시됨).
curl -H "Content-Type:application/json" -X POST -d \
'{
"name": "Flat rate card plan with freemium period",
"developer":null,
"developerCategory":null,
"advance": "false",
"currency": {
"id" : "usd"
},
"description": "Flat rate card plan with freemium period",
"displayName" : "Flat rate card plan with freemium period",
"frequencyDuration": "30",
"frequencyDurationType": "DAY",
"earlyTerminationFee": "10",
"monetizationPackage": {
"id": "location"
},
"organization": {
"id": "myorg"
},
"paymentDueDays": "30",
"prorate": "false",
"published": "false",
"ratePlanDetails": [
{
"currency": {
"aggregateFreemiumCounters" : true,
"aggregateStandardCounters" : true,
"id" : "usd"
},
"product" : {
"id" : "location",
"displayName":"Location"
},
"paymentDueDays": "30",
"meteringType": "UNIT",
"organization": {
"id": "myorg"
},
"ratePlanRates": [
{
"type": "RATECARD",
"rate": "0.10",
"startUnit": "0"
}
],
"freemiumUnit": "5000",
"freemiumDuration": "0",
"freemiumDurationType": "DAY",
"ratingParameterUnit":"MB",
"customPaymentTerm": "false",
"ratingParameter": "VOLUME",
"type": "RATECARD"
}],
"recurringStartUnit": 1,
"recurringType": "CALENDAR",
"recurringFee": "10",
"setUpFee": "10",
"startDate": "2013-09-15 00:00:00",
"type": "STANDARD"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/monetization-packages/location/rate-plans" \
-u email:password