현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보
소개
Apigee Edge 구성팀은 수익 창출을 초기 설정할 때 조직에서 지원하는 통화와 기본 통화를 구성합니다.
조직에서 지원하는 통화를 보거나, 지원되는 통화를 추가하거나, 지원되는 통화를 삭제할 수 있습니다 (개발자 또는 요금제에 사용되지 않는 통화인 경우).
UI를 사용하여 지원되는 통화 관리
조직 프로필 페이지의 세금 및 통화 섹션에서 지원되는 통화를 관리하고 기본 통화를 설정합니다. 자세한 내용은 UI를 사용하여 조직 프로필 관리를 참조하세요.
API를 사용하여 지원되는 통화 관리
다음 섹션에 설명된 대로 API를 사용하여 지원되는 통화를 관리하세요.
API를 사용하여 지원되는 통화 보기
조직에서 지원하는 개별 통화 또는 조직에서 지원하는 모든 통화를 확인합니다.
조직에서 지원하는 개별 통화를 보려면 /mint/organizations/{org_name}/supported-currencies/{supportedCurrencyId}에 GET 요청을 실행하세요. 여기서 {supportedCurrency_id}는 지원되는 통화의 ID입니다. 예를 들면 다음과 같습니다.
curl -X GET -H "Accept: application/json" \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/supported-currencies/usd" \
-u email:password
조직에서 지원하는 모든 통화를 보려면 /mint/organizations/{org_name}/supported-currencies에 GET 요청을 실행하세요. 예를 들면 다음과 같습니다.
curl -X GET "https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/supported-currencies" \
-H "Accept: application/json" \
-u email:password
다음은 응답의 예시입니다.
{
"supportedCurrency" : [ {
"description" : "US Dollar",
"displayName" : "US Dollar",
"id" : "usd",
"name" : "USD",
"organization" : {
...
"status" : "ACTIVE",
"virtualCurrency" : false
}, {
"creditLimit" : 5000.0000,
"description" : "Euro",
"displayName" : "Euro",
"id" : "eur",
"name" : "EUR",
"organization" : {
...
},
"status" : "INACTIVE",
"virtualCurrency" : false
} ],
"totalRecords" : 2
}
API를 사용하여 지원되는 통화 추가
/mint//organizations/{org_name}/supported-currencies에 POST 요청을 실행하여 지원되는 통화를 추가합니다. 추가하는 지원되는 통화별로 요청 본문에 다음 정보를 지정해야 합니다.
- 지원되는 통화의 이름입니다. 이름은 통화의 ISO 4217 코드입니다(예: 미국 달러의 경우 USD).
- 표시 이름입니다.
- 설명:
- 통화가 가상 화폐인지 여부입니다.
- 통화의 상태(즉, 통화를 사용할 수 있는지 여부)입니다.
- 지원되는 통화를 추가할 조직입니다.
원하는 경우 다음을 설정할 수 있습니다.
- 지원되는 통화에 대한 신용 한도 (후불 개발자만 해당)
- 지원되는 통화에 대한 최소 충전 (선불 개발자만 해당)
자세한 내용은 지원되는 통화 구성 속성을 참조하세요.
예를 들어 다음은 조직에 지원되는 통화를 추가합니다.
curl -H "Content-Type: application/json" -X POST -d \
'{
"description": "US Dollar",
"displayName": "US Dollar",
"virtualCurrency": "false",
"name": "USD",
"organization": {
"id": "{org_name}"
},
"status": "ACTIVE"
}' \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/supported-currencies" \
-u email:password
API를 사용하여 기본 통화 설정
API를 사용하여 조직 프로필 관리에 설명된 대로 조직 프로필을 수정할 때 currency 값을 지원되는 ISO 4217 통화 코드로 설정하여 조직의 기본 통화를 설정합니다.
API를 사용하여 지원되는 통화 수정
/mint/organizations/{org_name}/{supportedCurrencyId}에 PUT 요청을 실행하여 지원되는 통화를 수정합니다. 여기서 {supportedCurrency_id}는 업데이트할 지원되는 통화를 식별합니다. 업데이트된 속성과 지원되는 통화 ID를 요청 본문에 지정해야 합니다. 예를 들어 다음 API 호출은
지원되는 통화의 설명과 표시 이름을 수정합니다 (예시에서는 업데이트된 속성이
강조표시됨).
curl -H "Content-Type: application/json" -X PUT -d \
'{
"description": "United States Dollar",
"displayName": "United States Dollar",
"id": "usd",
"name": "USD",
"organization": {
"id": "{org_name}"
},
"status" : "ACTIVE",
"virtualCurrency": "false"
}' \
"https://api.enterprise.apigee.com/v1/mint/organization/{org_name}/supported-currencies/usd" -d \
-u email:password
API를 사용하여 지원되는 통화 삭제
/mint/organizations/{org_name}/supported-currencies/{currency_id}에 DELETE 요청을 실행하여 지원되는 통화를 삭제합니다. 여기서 {currency_id}는 삭제할 지원되는 통화를 식별합니다. 예를 들면 다음과 같습니다.
curl -X DELETE -H "Accept: application/json" \
"https://api.enterprise.apigee.com/v1/mint/organizations/{org_name}/supported-currencies/usd" \
-u email:password
API의 통화 구성 속성
다음 표에는 API를 사용하여 설정할 수 있는 구성 속성이 요약되어 있습니다.
| 이름 | 설명 | 기본 계정 | 필수 여부 |
|---|---|---|---|
| creditLimit |
이 속성은 후불 개발자에게만 적용됩니다. 지원되는 통화의 신용 한도입니다. |
N/A | No |
| 설명 |
지원되는 통화에 대한 설명입니다. |
N/A | 예 |
| displayName |
지원되는 통화에 대해 표시할 이름입니다. |
N/A | 예 |
| minimumTopupAmount |
이 속성은 선불 개발자에게만 적용됩니다. 개발자가 지정된 통화로 선불 계정 잔액에 추가할 수 있는 최소 금액입니다. |
N/A | No |
| 이름 |
통화의 ISO 4217 코드입니다(예: 미국 달러의 경우 USD). |
N/A | 예 |
| 조직 |
지원되는 통화의 조직입니다. |
N/A | 예 |
| status |
지원되는 통화의 상태입니다. 유효한 값으로 다음이 포함되어 있습니다.
|
N/A | 예 |
| virtualCurrency |
지원되는 통화가 가상 통화인지 여부를 나타냅니다. 유효한 값으로 다음이 포함되어 있습니다.
|
N/A | 예 |