Endpoints
Recuperar dados de localização
GET | https://api.iglobalstores.com/2.0/localizationExchange - Recupera dados de localização que incluem informações a nível de país, além de detalhes sobre a moeda local e a rate de câmbio.
Solicitação HTTPS
| Campo | Notas |
|---|---|
| Método HTTP | GET |
| URL do Endpoint | https://test-api.iglobalstores.com/2.0/localizationExchange |
| Protocolo | HTTPS |
| Formato da mensagem | JSON |
| Cabeçalho HTTP Accept | Accept: application/json |
| Cabeçalho HTTP do Token de Segurança | serviceToken: seu-valor-de-token-de-testeAdicione um cabeçalho à sua solicitação HTTPS chamado serviceToken com o valor do seu token de segurança de teste da API. (Entre em contato com seu Gerente de Conta para obter este token.) |
Parâmetros de solicitação de URL
| Campo | Notas |
|---|---|
countryCode | Código de país de dois caracteres do país fornecido armazenado dentro do mapa específico do país para conveniência; também armazenado como a chave usada para recuperar o mapa específico do país. Valores de exemplo: CA ou AU |
format (recomendado) | Valor verdadeiro ou falso para indicar se deve ou não retornar informações de formatação. |
Resposta HTTPS
Formato da mensagem: JSON
Exemplo de resposta (apenas Canadá)
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": ","
}
}
Definições JSON de resposta
| Campo | Notas |
|---|---|
country | Este é um mapa com as chaves sendo códigos de país de dois caracteres e os valores sendo mapas que contêm o nome, código e código de moeda do país específico. |
country[codigo_pais].code | Código de país de dois caracteres do país dado armazenado dentro do mapa específico do país para conveniência; também armazenado como a chave usada para recuperar o mapa específico do país. Exemplos de valores: CA ou AU |
country[codigo_pais].currency | O código de moeda de dois caracteres a ser usado com este país. Para alguns países, é melhor usar USD, porque sua moeda flutua muito dramaticamente em valor. Exemplos de valores: CAD ou AUD ou USD |
country[codigo_pais].currencySymbol | O símbolo usado para identificar essa moeda no navegador. |
country[codigo_pais].decimalDelimiter | Aparece apenas se o parâmetro de consulta de formato for verdadeiro; mostra o caractere usado para o ponto decimal para a moeda. |
country[codigo_pais].rateEstimate | A rate a ser multiplicada para converter USD para a moeda específica para preços estrangeiros estimados. Você usaria essa rate quando pretende cobrar o cliente em USD, mas mostrar preços localizados em sua moeda estrangeira. Por exemplo, 10 USD multiplicados por 1,0312 (a rate fornecida para CAD) = 10,31 CAD (preço em CAD arredondado usando o método "meio para cima"). Exemplos de valores: 1,0312 ou 0,8501 (As taxas podem conter até 6 dígitos de precisão, ou seja, 1,123456.) |
country[codigo_pais].thousandDelimiter | Aparece apenas se o parâmetro de consulta de formato for verdadeiro. Mostra o caractere que indica a divisão entre marcadores de mil/milhão/bilhão para a moeda. |
format (recomendado) | Valor verdadeiro ou falso para indicar se deve ou não retornar informações de formatação. |
API Legada de Troca de Localização
Saiba como funciona a API Legada de Troca de Localização.A API de troca de localização retorna dados de localização que contêm especificidades de cada país, moedas e taxas de câmbio.