엔드포인트
로컬라이제이션 데이터 검색
GET | https://api.iglobalstores.com/2.0/localizationExchange - 국가 수준의 정보와 함께 현지 통화 및 환율 rate 세부정보를 포함하는 로컬라이제이션 데이터를 검색합니다.
HTTPS 요청
| 필드 | 비고 |
|---|---|
| HTTP 메서드 | GET |
| 엔드포인트 URL | https://test-api.iglobalstores.com/2.0/localizationExchange |
| 프로토콜 | HTTPS |
| 메시지 형식 | JSON |
| 수락 HTTP 헤더 | Accept: application/json |
| 보안 토큰 HTTP 헤더 | serviceToken: your-test-token-valueHTTPS 요청에 serviceToken이라는 이름의 헤더를 추가하고 테스트 보안 API 토큰의 값을 입력하세요. (이 토큰은 계정 관리자에게 문의하세요.) |
URL 요청 매개변수
| 필드 | 비고 |
|---|---|
countryCode | 편의를 위해 국가별 맵에 저장된 주어진 국가의 두 글자 국가 코드; 또한 국가별 맵을 검색하는 데 사용되는 키로 저장됩니다. 예시 값: CA 또는 AU |
format (권장) | 포맷팅 정보를 반환할지 여부를 나타내는 true 또는 false 값입니다. |
HTTPS 응답
메시지 형식: JSON
예시 응답 (캐나다 전용)
1
2
3
4
5
6
7
8
9
10
11
12
{
"CA": {
"code": "CA",
"currency": "CAD",
"currencySymbol": "$",
"decimalDelimiter": ".",
"name": "Canada",
"rateEstimate": "1.42813",
"scale": "2",
"thousandsDelimiter": ","
}
}
응답 JSON 정의
| 필드 | 비고 |
|---|---|
country | 두 글자 국가 코드가 키이고, 특정 국가의 이름, 코드 및 통화 코드가 포함된 맵이 값인 맵입니다. |
country[country_code].code | 편의를 위해 국가별 맵에 저장된 주어진 국가의 두 글자 국가 코드; 국가별 맵을 검색하는 데 사용되는 키로도 저장됩니다. 예시 값: CA 또는 AU |
country[country_code].currency | 이 국가와 함께 사용할 두 글자 통화 코드입니다. 일부 국가의 경우, 통화 가치가 너무 극적으로 변동하기 때문에 USD를 사용하는 것이 가장 좋습니다. 예시 값: CAD 또는 AUD 또는 USD |
country[country_code].currencySymbol | 브라우저에서 해당 통화를 식별하는 데 사용되는 기호입니다. |
country[country_code].decimalDelimiter | format 쿼리 매개변수가 true인 경우에만 나타나며, 통화의 소수점에 사용되는 문자를 보여줍니다. |
country[country_code].rateEstimate | USD를 특정 통화로 변환하기 위해 곱해야 하는 rate입니다. 고객에게 USD로 요금을 청구하려고 하지만 가격을 해당 외화로 지역화하여 표시하려는 경우 이 rate를 사용합니다. 예를 들어, 10 USD에 1.0312(주어진 CAD에 대한 rate)를 곱하면 10.31 CAD(“반올림” 방법을 사용하여 반올림된 CAD 가격)가 됩니다. 예시 값: 1.0312 또는 0.8501 (요금은 최대 6자리의 정밀도를 가질 수 있습니다, 즉 1.123456.) |
country[country_code].thousandDelimiter | format 쿼리 매개변수가 true인 경우에만 나타납니다. 통화의 천/백만/십억 구분 기호를 나타내는 문자를 보여줍니다. |
format (권장) | 포맷팅 정보를 반환할지 여부를 나타내는 true 또는 false 값입니다. |
로컬라이제이션 교환 API 레거시
레거시 로컬라이제이션 교환 API가 작동하는 방식을 알아보세요.
로컬라이제이션 교환 API는 국가별 세부정보, 통화 및 환율을 포함하는 로컬라이제이션 데이터를 반환합니다.