Конечные точки
Получить данные локализации
GET | https://api.iglobalstores.com/2.0/localizationExchange
- Извлекает данные локализации, которые включают информацию на уровне страны, а также детали местной валюты и обменного rate курса.
HTTPS запрос
Поле | Примечания |
---|---|
HTTP метод | GET |
URL конечной точки | https://test-api.iglobalstores.com/2.0/localizationExchange |
Протокол | HTTPS |
Формат сообщения | JSON |
Заголовок Accept HTTP | Accept: application/json |
Заголовок токена безопасности HTTP | serviceToken : your-test-token-valueДобавьте заголовок к вашему HTTPS запросу с именем 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 | rate для умножения, чтобы конвертировать USD в конкретную валюту для оценки иностранной цены. Вы бы использовали этот rate когда намереваетесь взимать с клиента плату в USD, но показывать цены, локализованные для их иностранной валюты. Например, 10 USD, умноженные на 1.0312 (значение rate для CAD) = 10.31 CAD (цена в CAD, округленная с использованием метода "половина вверх"). Примеры значений: 1.0312 или 0.8501 (Ставки могут содержать до 6 знаков после запятой, т.е. 1.123456.) |
country[country_code].thousandDelimiter | Появляется только если параметр запроса format равен true. Показывает символ, который указывает на разделение между тысячами/миллионами/миллиардами для валюты. |
format (рекомендуется) | Значение true или false, указывающее, следует ли возвращать информацию о форматировании. |
Устаревший API обмена локализацией
Узнайте, как работает устаревший API обмена локализацией.API обмена локализацией возвращает данные локализации, которые содержат информацию о стране, валюте и обменных курсах.