Insérer les prix des index électriques via une API

S’abonner

Dans cet article, vous allez apprendre comment visualiser le coût d'un prix dont le taux change en fonction de ce que vous insérez via une API.

Introduction

Avez-vous accès au prix exact de l'électricité (€/kWh) par heure ou par demi-heure ?

Souhaitez-vous voir le coût en fonction de ces prix sur la plateforme ?

Dans cet article, nous expliquons comment faire cela.

Prérequis

  • Vous devez disposer d'un dispositif avec des données d'énergie active, de sorte que le prix puisse être appliqué à quelque chose, puis visualisé.
  • Vous devrez avoir une application enregistrée sur la plateforme. Voyez comment le faire dans cet article.
    • Cette application doit avoir l'autorisation "Lecture et écriture" :
    • À partir de cette application, vous aurez besoin du jeton permanent (x-dexcell-token)

Configuration

Une fois que vous avez l'application et le jeton permanent, voici une explication étape par étape sur la manière de procéder. Nous vous recommandons de configurer d'abord la fourniture et le contrat, de sorte que dès que vous insérez les prix, vous pourrez voir le coût. Suivez ces étapes :

  1. Accédez à Configuration > Fournitures et prix.
  2. Créez un prix dans l'interface de la plateforme. Cette étape ne peut pas être réalisée via une API.
    • Indiquez le nom et sélectionnez la structure tarifaire, les excédents et la puissance que vous souhaitez, mais choisissez "Basé sur la consommation du marché de gros".
    • Choisissez la fréquence à laquelle les prix seront insérés :

      Screenshot_2023-05-11_at_12.33.24.png

      Cela ne signifie pas que les prix doivent être mis à jour toutes les heures ou toutes les 30 minutes. Tous les prix horaires/30 minutes peuvent être téléchargés à la fin de la journée ou de la semaine, par exemple.
    • Ajoutez d'autres coûts et taxes si nécessaire.
  3. Créez maintenant une nouvelle fourniture et un contrat actif. Cette étape peut également être réalisée via l'API.
  4. Attribuez la fourniture au dispositif qui détient les données électriques. Vous pouvez le faire soit via l'interface de la plateforme (processus expliqué ici) soit avec la configuration de compte en vrac.
  5. L'étape la plus importante : insérez les prix via une API avec notre appel "Créer des tarifs indexés pour un prix" documenté ici. Vous aurez besoin de la clé de prix visible dans la configuration de prix et du jeton de l'application en tant qu'en-tête. Voici un exemple depuis Postman :Screenshot_2023-05-11_at_12.44.18.png
  6. Si votre dispositif dispose de données de consommation pour les heures pour lesquelles vous avez inséré des prix, vous pouvez maintenant accéder à l'écran de coût et les visualiser !

 

Conseil

Si l'API renvoie une erreur 403, n'oubliez pas l'exigence d'avoir l'autorisation de lecture et d'écriture dans la configuration de votre application.

Avez-vous trouvé cet article utile ?