현재 Apigee Edge 문서를 보고 있습니다.
Apigee X 문서로 이동 정보
소개
수익 창출 초기 설정의 일환으로 Apigee Edge 구성팀은 조직에서 지원하는 통화와 기본 통화를 구성합니다.
조직에서 지원하는 통화를 확인하거나, 지원되는 통화를 추가하거나, 개발자 또는 요금제에서 사용하지 않는 통화를 삭제할 수 있습니다.
UI를 사용하여 지원되는 통화 관리
조직 프로필 페이지의 세금 및 통화 섹션에서 지원되는 통화를 관리하고 기본 통화를 설정합니다. 자세한 내용은 UI를 사용하여 조직 프로필 관리를 참고하세요.
API를 사용하여 지원되는 통화 관리
다음 섹션에 설명된 대로 API를 사용하여 지원되는 통화를 관리합니다.
API를 사용하여 지원되는 통화 보기
조직에서 지원하는 개별 통화 또는 조직에서 지원하는 모든 통화를 확인합니다.
조직에서 지원하는 개별 통화를 보려면 /mint/organizations/{org_name}/supported-currencies/{supportedCurrencyId}에 GET 요청을 실행합니다. 여기서 {supportedCurrency_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 |
이 속성은 후불 개발자에게만 적용됩니다. 지원되는 통화의 신용 한도입니다. |
해당 사항 없음 | 아니요 |
| 설명 |
지원되는 통화에 대한 설명입니다. |
해당 사항 없음 | 예 |
| displayName |
지원되는 통화의 표시 이름입니다. |
해당 사항 없음 | 예 |
| minimumTopupAmount |
이 속성은 선불 개발자에게만 적용됩니다. 개발자가 지정된 통화로 선불 계정 잔액에 추가할 수 있는 최소 금액입니다. |
해당 사항 없음 | 아니요 |
| 이름 |
통화의 ISO 4217 코드입니다(예: 미국 달러의 경우 USD). |
해당 사항 없음 | 예 |
| 조직 |
지원되는 통화를 사용하는 조직입니다. |
해당 사항 없음 | 예 |
| 상태 |
지원되는 통화의 상태입니다. 유효한 값으로 다음이 포함되어 있습니다.
|
해당 사항 없음 | 예 |
| virtualCurrency |
지원되는 통화가 가상 통화인지 여부를 나타냅니다. 유효한 값으로 다음이 포함되어 있습니다.
|
해당 사항 없음 | 예 |