Merci de votre intérêt pour l’interface Valet de la Banque du Canada. Pour commencer, apprenez-en plus sur l’interface Valet. Vous pourrez ensuite vous lancer et trouver des données, effectuer des appels d’API et extraire des taux de change.
Si vous avez des questions ou des préoccupations qui ne sont pas abordées dans la présente documentation, .
Important : Conditions d’utilisation
Veuillez consulter nos conditions d’utilisation et notre avis d’exonération de responsabilité lorsque vous vous servez de l’interface Valet.
À propos de l’interface Valet
Les services Web Valet de la Banque du Canada permettent d’accéder, grâce à la programmation informatique, à des données financières internationales.
Vous pouvez utiliser l’interface Valet pour extraire les données et les informations financières publiées par la Banque du Canada, telles que :
- les taux de change
- des statistiques économiques (y compris celles en lien avec des études, des prévisions et des analyses)
- d’autres statistiques et rapports financiers
Inscription
Aucune inscription ni clé d’accès n’est requise pour utiliser l’interface Valet.
Coût
L’utilisation de l’interface Valet est gratuite.
Limites de demandes
Pour en savoir plus sur l’utilisation acceptable du site Web de la Banque et de l’interface Valet, veuillez consulter nos conditions d’utilisation.
Voici quelques conseils pour éviter d’atteindre les limites de demandes ou de surcharger le système :
- Allez-y doucement aux heures de pointe : Augmentez graduellement le rythme de vos demandes pour éviter les délais d’attente ou les échecs de demandes.
- Réessayez prudemment : Si votre demande échoue, attendez avant de réessayer. En ajoutant des périodes d’attente de durées aléatoires ou exponentielles, vous réduisez le risque d’échecs à répétition.
- La mémoire cache est votre amie : Pour les données publiées une seule fois par jour, comme les taux de change, consignez la réponse au lieu de refaire l’appel d’API.
Ces étapes vous permettront d’utiliser efficacement l’interface Valet et d’assurer son bon fonctionnement pour tout le monde.
Mises à jour des données
Nous nous efforçons de mettre régulièrement les données à jour, mais il peut y avoir un bref délai de traitement entre leur publication et le moment où elles apparaissent dans l’interface Valet. Si vous n’arrivez pas à les voir immédiatement, réessayez plus tard.
Certificats
Pour assurer le bon fonctionnement de ses sites Web et de ses services, la Banque se réserve le droit de modifier ou de mettre à jour les certificats à tout moment et sans préavis.
Nous ne fournissons aucun certificat ou soutien technique pour nos sites banqueducanada.ca ou bankofcanada.ca – vous pouvez utiliser l’un ou l’autre avec l’interface Valet. Cependant, puisque les certificats existants sont publics, vous pouvez les trouver en ligne.
Conditions d’utilisation
N’oubliez pas de lire et de respecter nos conditions d’utilisation et notre avis d’exonération deresponsabilité.
Trouver des données
Pour repérer une série ou un groupe de données avec l’interface Valet, essayez d’utiliser la fonctionnalité « Listes > Get », qui se trouve dans la documentation sur les points de terminaison.
Vous pouvez également vous servir du site Web de la Banque du Canada pour chercher les séries et les groupes disponibles. En général, les données téléchargeables sont aussi accessibles par l’entremise de l’interface Valet. Ces pages de téléchargement offrent souvent des renseignements complémentaires sur les données, tels que la date de publication.
Effectuer des appels d’API
Avant de faire un appel d’interface de programmation d’applications (API), vous devez vous assurer de faire ce qui suit.
Ajouter un préfixe à toutes les routes
Chaque route d’API que vous utilisez doit commencer par l’une des URL racines suivantes :
https://www.banqueducanada.ca/valet/https://www.bankofcanada.ca/valet/
Utiliser des paramètres de requête
Bien que le format et les paramètres des routes soient flexibles, chaque appel d’API doit contenir au moins l’un des éléments suivants :
- nom de série (
seriesName) – voir la rubrique « Listes » dans la documentation sur les points de terminaison - nom de groupe (
groupName) – voir la rubrique « Listes » dans la documentation sur les points de terminaison format– choisir l’un des formats de sortie suivants : JSON, CSV ou XML
Les autres paramètres sont facultatifs, mais vous pouvez les utiliser pour affiner votre requête. Pour en savoir plus, consultez la documentation sur les points de terminaison.
Extraire des taux de change
Vous pouvez utiliser l’interface Valet pour extraire des taux de change quotidiens, mensuels et annuels. Pour connaître la liste des devises pour lesquelles le taux de change est disponible ainsi que la méthode de calcul, consultez ce document d’information.
Comme les taux de change ne sont publiés qu’une fois par jour, vous pouvez respecter les limites de demandes en mettant en mémoire cache les résultats que vous obtenez de la Banque.