Điểm cuối
Lấy dữ liệu địa phương hóa
GET | https://api.iglobalstores.com/2.0/localizationExchange
- Lấy dữ liệu địa phương hóa bao gồm thông tin cấp quốc gia cùng với tiền tệ địa phương và chi tiết tỷ giá rate.
Yêu cầu HTTPS
Trường | Ghi chú |
---|---|
Phương thức HTTP | GET |
URL điểm cuối | https://test-api.iglobalstores.com/2.0/localizationExchange |
Giao thức | HTTPS |
Định dạng tin nhắn | JSON |
Tiêu đề HTTP chấp nhận | Accept: application/json |
Tiêu đề HTTP mã thông báo bảo mật | serviceToken : your-test-token-valueThêm một tiêu đề vào yêu cầu HTTPS của bạn có tên serviceToken với giá trị là mã thông báo API bảo mật thử nghiệm của bạn. (Liên hệ với Quản lý Tài khoản của bạn để biết mã này.) |
Tham số yêu cầu URL
Trường | Ghi chú |
---|---|
countryCode | Mã quốc gia hai ký tự của quốc gia đã cho được lưu trữ trong bản đồ cụ thể theo quốc gia để tiện lợi; cũng được lưu trữ như là khóa được sử dụng để lấy bản đồ cụ thể theo quốc gia. Ví dụ: CA hoặc AU |
format (được khuyến nghị) | Giá trị đúng hoặc sai để chỉ ra liệu có trả về thông tin định dạng hay không. |
Phản hồi HTTPS
Định dạng tin nhắn: JSON
Ví dụ phản hồi (chỉ Canada)
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": ","
}
}
Định nghĩa JSON phản hồi
Trường | Ghi chú |
---|---|
country | Đây là một bản đồ với các khóa là mã quốc gia hai ký tự và các giá trị là các bản đồ chứa tên, mã và mã tiền tệ của quốc gia cụ thể. |
country[country_code].code | Mã quốc gia hai ký tự của quốc gia được lưu trữ trong bản đồ quốc gia cụ thể để tiện lợi; cũng được lưu trữ như khóa dùng để truy xuất bản đồ quốc gia cụ thể. Ví dụ: CA hoặc AU |
country[country_code].currency | Mã tiền tệ hai ký tự để sử dụng với quốc gia này. Đối với một số quốc gia, tốt nhất là sử dụng USD, vì tiền tệ của họ dao động quá mạnh. Ví dụ: CAD hoặc AUD hoặc USD |
country[country_code].currencySymbol | Ký hiệu được sử dụng để nhận diện tiền tệ đó trong trình duyệt. |
country[country_code].decimalDelimiter | Chỉ xuất hiện nếu tham số truy vấn định dạng là đúng; hiển thị ký tự được sử dụng cho dấu thập phân của tiền tệ. |
country[country_code].rateEstimate | rate để nhân với để chuyển đổi USD sang tiền tệ cụ thể cho ước tính giá nước ngoài. Bạn sẽ sử dụng rate này khi bạn dự định tính phí khách hàng bằng USD nhưng hiển thị giá được địa phương hóa sang tiền tệ nước ngoài của họ. Ví dụ, 10 USD nhân với 1.0312 (rate được cung cấp cho CAD) = 10.31 CAD (giá bằng CAD được làm tròn bằng phương pháp “half up”). Ví dụ: 1.0312 hoặc 0.8501 (Tỷ giá có thể chứa đến 6 chữ số chính xác, tức là 1.123456.) |
country[country_code].thousandDelimiter | Chỉ xuất hiện nếu tham số truy vấn định dạng là đúng. Hiển thị ký tự chỉ ra sự phân chia giữa các dấu hiệu nghìn/triệu/tỷ cho tiền tệ. |
format (khuyến nghị) | Giá trị đúng hoặc sai để chỉ ra có trả về thông tin định dạng hay không. |
API Địa phương hóa Exchange Legacy
Tìm hiểu cách hoạt động của API Địa phương hóa Exchange Legacy.
API địa phương hóa exchange trả về dữ liệu địa phương hóa chứa thông tin cụ thể theo quốc gia, tiền tệ và tỷ giá hối đoái.