Points de terminaison
Récupérer les données de localisation
GET | https://api.iglobalstores.com/2.0/localizationExchange
- Récupère des données de localisation incluant des informations au niveau des pays ainsi que des détails sur les devises locales et les rate de change.
Requête HTTPS
Champ | Remarques |
---|---|
Méthode HTTP | GET |
URL du point de terminaison | https://test-api.iglobalstores.com/2.0/localizationExchange |
Protocole | HTTPS |
Format du message | JSON |
En-tête HTTP Accept | Accept: application/json |
En-tête HTTP du jeton de sécurité | serviceToken : your-test-token-valueAjoutez un en-tête à votre requête HTTPS nommé serviceToken avec une valeur de votre jeton de sécurité API de test. (Contactez votre gestionnaire de compte pour ce jeton.) |
Paramètres de requête URL
Champ | Remarques |
---|---|
countryCode | Code pays à deux caractères du pays donné stocké dans la carte spécifique au pays pour plus de commodité; également stocké comme clé utilisée pour récupérer la carte spécifique au pays. Exemples de valeurs : CA ou AU |
format (recommandé) | Valeur vraie ou fausse pour indiquer s'il faut ou non renvoyer des informations de formatage. |
Réponse HTTPS
Format du message: JSON
Exemple de réponse (Canada uniquement)
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": ","
}
}
Définitions JSON de réponse
Champ | Notes |
---|---|
country | Il s'agit d'une carte avec les clés étant des codes de pays à deux caractères et les valeurs étant des cartes contenant le nom, le code et le code de devise du pays spécifique. |
country[country_code].code | Code de pays à deux caractères du pays donné stocké à l'intérieur de la carte spécifique au pays pour plus de commodité ; également stocké en tant que clé utilisée pour récupérer la carte spécifique au pays. Exemples de valeurs : CA ou AU |
country[country_code].currency | Le code de devise à deux caractères à utiliser avec ce pays. Pour certains pays, il est préférable d'utiliser USD, car leur devise fluctue trop fortement en valeur. Exemples de valeurs : CAD ou AUD ou USD |
country[country_code].currencySymbol | Le symbole utilisé pour identifier cette devise dans le navigateur. |
country[country_code].decimalDelimiter | Apparaît uniquement si le paramètre de requête de format est vrai ; montre le caractère utilisé pour le point décimal pour la devise. |
country[country_code].rateEstimate | Le rate à multiplier pour convertir USD dans la devise spécifique pour l'estimation des prix étrangers. Vous utiliseriez ce rate lorsque vous avez l'intention de facturer le client en USD mais d'afficher les prix localisés dans leur devise étrangère. Par exemple, 10 USD multiplié par 1,0312 (le rate donné pour CAD) = 10,31 CAD (prix en CAD arrondi en utilisant la méthode "half up"). Exemples de valeurs : 1,0312 ou 0,8501 (Les taux peuvent contenir jusqu'à 6 chiffres de précision, c'est-à-dire 1,123456.) |
country[country_code].thousandDelimiter | Apparaît uniquement si le paramètre de requête de format est vrai. Montre le caractère qui indique la division entre le marqueur de millier/million/milliard pour la devise. |
format (recommandé) | Valeur vraie ou fausse pour indiquer s'il faut ou non renvoyer des informations de formatage. |
API Legacy Localization Exchange
Découvrez comment fonctionne l'API Legacy Localization Exchange.
L'API de localisation renvoie des données de localisation contenant des informations spécifiques aux pays, des devises et des taux de change.