Endpoint
Ambil data lokalisasi
GET | https://api.iglobalstores.com/2.0/localizationExchange - Mengambil data lokalisasi yang mencakup informasi tingkat negara ditambah rincian mata uang lokal dan nilai tukar rate.
Permintaan HTTPS
| Field | Notes |
|---|---|
| Metode HTTP | GET |
| URL Endpoint | https://test-api.iglobalstores.com/2.0/localizationExchange |
| Protokol | HTTPS |
| Format pesan | JSON |
| Header HTTP Accept | Accept: application/json |
| Header HTTP Token Keamanan | serviceToken: your-test-token-valueTambahkan header ke permintaan HTTPS Anda bernama serviceToken dengan nilai token API keamanan uji Anda. (Hubungi Manajer Akun Anda untuk token ini.) |
Parameter permintaan URL
| Field | Notes |
|---|---|
countryCode | Kode negara dua karakter dari negara yang diberikan yang disimpan di dalam peta spesifik negara untuk kenyamanan; juga disimpan sebagai kunci yang digunakan untuk mengambil peta spesifik negara.Contoh nilai: CA atau AU |
format (disarankan) | Nilai benar atau salah untuk menunjukkan apakah atau tidak untuk mengembalikan informasi format. |
Respons HTTPS
Format pesan: JSON
Contoh respons (hanya 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": ","
}
}
Definisi JSON Respons
| Field | Catatan |
|---|---|
country | Ini adalah peta dengan kunci berupa kode negara dua karakter dan nilai berupa peta yang berisi nama, kode, dan kode mata uang dari negara tertentu. |
country[country_code].code | Kode negara dua karakter dari negara yang diberikan yang disimpan di dalam peta spesifik negara untuk kenyamanan; juga disimpan sebagai kunci yang digunakan untuk mengambil peta spesifik negara. Contoh nilai: CA atau AU |
country[country_code].currency | Kode mata uang dua karakter yang digunakan dengan negara ini. Untuk beberapa negara, sebaiknya menggunakan USD, karena mata uang mereka berfluktuasi nilainya terlalu dramatis. Contoh nilai: CAD atau AUD atau USD |
country[country_code].currencySymbol | Simbol yang digunakan untuk mengidentifikasi mata uang tersebut di browser. |
country[country_code].decimalDelimiter | Muncul hanya jika parameter kueri format adalah true; menunjukkan karakter yang digunakan untuk titik desimal untuk mata uang. |
country[country_code].rateEstimate | rate yang harus dikalikan untuk mengonversi USD ke mata uang tertentu untuk perkiraan harga asing. Anda akan menggunakan rate ini ketika Anda berniat untuk mengenakan biaya kepada pelanggan dalam USD tetapi menunjukkan harga yang dilokalisasi ke mata uang asing mereka. Misalnya, 10 USD dikalikan dengan 1.0312 (nilai rate yang diberikan untuk CAD) = 10.31 CAD (harga dalam CAD dibulatkan menggunakan metode “setengah ke atas”). Contoh nilai: 1.0312 atau 0.8501 (Tarif dapat mengandung hingga 6 digit presisi, yaitu 1.123456.) |
country[country_code].thousandDelimiter | Muncul hanya jika parameter kueri format adalah true. Menunjukkan karakter yang menunjukkan pembagian antara tanda ribuan/jutaan/miliar untuk mata uang. |
format (disarankan) | Nilai true atau false untuk menunjukkan apakah akan mengembalikan informasi format atau tidak. |
API Pertukaran Lokalisasi Warisan
Pelajari cara kerja API Pertukaran Lokalisasi Warisan.API pertukaran lokalisasi mengembalikan data lokalisasi yang berisi spesifik negara, mata uang, dan nilai tukar.