Punkty końcowe
Pobierz dane lokalizacyjne
GET | https://api.iglobalstores.com/2.0/localizationExchange
- Pobiera dane lokalizacyjne, które obejmują informacje na poziomie kraju oraz szczegóły dotyczące lokalnej waluty i kursów rate.
Żądanie HTTPS
Pole | Uwagi |
---|---|
Metoda HTTP | GET |
URL punktu końcowego | https://test-api.iglobalstores.com/2.0/localizationExchange |
Protokół | HTTPS |
Format wiadomości | JSON |
Nagłówek Accept HTTP | Accept: application/json |
Nagłówek tokena bezpieczeństwa HTTP | serviceToken : your-test-token-valueDodaj nagłówek do swojego żądania HTTPS o nazwie serviceToken z wartością swojego testowego tokena API bezpieczeństwa. (Skontaktuj się ze swoim menedżerem konta w celu uzyskania tego tokena.) |
Parametry żądania URL
Pole | Uwagi |
---|---|
countryCode | Dwuznakowy kod kraju danego kraju przechowywany w mapie specyficznej dla kraju dla wygody; również przechowywany jako klucz używany do pobrania mapy specyficznej dla kraju.Przykładowe wartości: CA lub AU |
format (zalecane) | Wartość prawda lub fałsz, aby wskazać, czy zwrócić informacje o formatowaniu, czy nie. |
Odpowiedź HTTPS
Format wiadomości: JSON
Przykładowa odpowiedź (tylko Kanada)
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": ","
}
}
Definicje odpowiedzi JSON
Pole | Uwagi |
---|---|
country | To jest mapa, w której klucze to dwuznakowe kody krajów, a wartości to mapy zawierające nazwę, kod i kod waluty danego kraju. |
country[country_code].code | Dwuznakowy kod kraju danego kraju przechowywany wewnątrz mapy specyficznej dla kraju dla wygody; również przechowywany jako klucz używany do pobierania mapy specyficznej dla kraju. Przykładowe wartości: CA lub AU |
country[country_code].currency | Dwuznakowy kod waluty do użycia z tym krajem. Dla niektórych krajów najlepiej jest używać USD, ponieważ ich waluta zbyt dramatycznie waha się w wartości. Przykładowe wartości: CAD lub AUD lub USD |
country[country_code].currencySymbol | Symbol używany do identyfikacji tej waluty w przeglądarce. |
country[country_code].decimalDelimiter | Pojawia się tylko wtedy, gdy parametr zapytania format jest ustawiony na true; pokazuje znak używany jako separator dziesiętny dla waluty. |
country[country_code].rateEstimate | rate do pomnożenia, aby przeliczyć USD na konkretną walutę w celu oszacowania cen zagranicznych. Użyjesz tego rate gdy zamierzasz obciążyć klienta w USD, ale pokazać ceny zlokalizowane w ich zagranicznej walucie. Na przykład, 10 USD pomnożone przez 1.0312 ( rate podany dla CAD) = 10.31 CAD (cena w CAD zaokrąglona metodą „half up”). Przykładowe wartości: 1.0312 lub 0.8501 (Stawki mogą zawierać do 6 cyfr precyzji, tzn. 1.123456.) |
country[country_code].thousandDelimiter | Pojawia się tylko wtedy, gdy parametr zapytania format jest ustawiony na true. Pokazuje znak, który wskazuje podział między markerem tysięcy/milionów/miliardów dla waluty. |
format (zalecane) | Wartość true lub false, aby wskazać, czy zwrócić informacje o formatowaniu. |
API wymiany lokalizacji - wersja legacy
Dowiedz się, jak działa Legacy API wymiany lokalizacji.API wymiany lokalizacji zwraca dane lokalizacyjne, które zawierają szczegóły dotyczące kraju, walut i kursów wymiany.