Interface de programmation d’application ( IPA ) du taux de change

Utilisation

L’IPA permet aux utilisateurs de rechercher des taux de change de devises étrangères. Les taux enregistrés indiquent le nombre de dollars canadiens nécessaires pour acheter une seule unité de la devise étrangère. Les nouveaux taux sont publiés par la Banque du Canada (BdC) chaque jour à 16 h 30. L'Agence des services frontaliers du Canada (ASFC) récupère ces mises à jour entre 16 h 30 et 17 h (HNE).

La BdC fournit les taux de 23 devises étrangères. Tous les autres taux sont maintenus par l'ASFC.

Les taux de change de la BdC sont mis à jour quotidiennement dans le système alors que les autres taux de changes sont mis à jour par l’ASFC à des intervalles déterminés . Les taux actualisés sont disponibles pour récupération  entre 19 h et 23 h 59 (HNE).

Si l’intervalle ci-haut mentionné est manqué, l’utilisateur peut encore récupérer les taux de change actifs en utilisant l’IPA des taux de change historiques.

S’il-vous-plaît noter que l’utilisation de l’IPA des taux de change historiques :

1. Requiert des paramètres de date de début et date de fin.
2. Si vous récupérez une grande quantité de données, utilisez les paramètres limites et de sauts.

Fréquence de mise à jour

Compte tenu que la BdC publie ses taux de change à chaque jour ouvrable, il est recommandé de récupérer quotidiennement les données relatives aux taux de change. Cette récupération doit avoir lieu après 19 h (HNE) pour assurer la récupération des dernières mises à jour.

Notes techniques

Le taux de change IPA utilise LoopBack 4, un cadre à source ouverte pour créer une IPA REST dynamique d’un bout à l’autre. Veuillez vous référer à l’AWS API Gateway pour plus de détails. Deux serveurs seront fournis, un pour le développement et les tests et l'autre pour les données de production réelles. Veuillez vous assurer qu'ils sont accessibles de façon appropriée pendant le cycle de vie du développement.

   "ForeignExchangeRates": [
        {
            "ExchangeRateId": 719352,
            "Rate": "0.1589",
            "ExchangeRateEffectiveTimestamp": "2021-11-03T00:00:00.000Z",
            "ExchangeRateExpiryTimestamp": "2021-11-03T23:59:59.000Z",
            "ExchangeRateSource": "BoC",
            "FromCurrency": {
                "Value": "HKD"
            },
            "FromCurrencyCSN": 87,
            "ToCurrency": {
                "Value": "CAD"
            },
            "ToCurrencyCSN": 36
        } ]

  "ForeignExchangeRates": [
        
	{
            "ExchangeRateId": 718988,
            "Rate": "0",
            "ExchangeRateEffectiveTimestamp": "2021-10-22T00:00:00.000Z",
            "ExchangeRateExpiryTimestamp": "2021-10-22T23:59:59.000Z",
            "ExchangeRateSource": "CBSA",
            "FromCurrency": {
                "Value": "bpg"
            },
            "FromCurrencyCSN": 267,
            "ToCurrency": {
                "Value": "CAD"
            },
            "ToCurrencyCSN": 36
        },
        {
            "ExchangeRateId": 718990,
            "Rate": "0",
            "ExchangeRateEffectiveTimestamp": "2021-10-22T00:00:00.000Z",
            "ExchangeRateExpiryTimestamp": "2021-10-22T23:59:59.000Z",
            "ExchangeRateSource": "CBSA",
            "FromCurrency": {
                "Value": "mpg"
            },
            "FromCurrencyCSN": 266,
            "ToCurrency": {
                "Value": "CAD"

            },
            "ToCurrencyCSN": 36
        },
 ]