N.B: Because this tool is targeted for french people, the documentation is...in french
Ce module vous permet de récupérer votre consommation et production électrique Linky via le service Conso API
Il peut s'utiliser de 2 façons :
- En ligne de commande
- En tant que module Node.js, depuis un autre programme
Notez qu'il vous faut un compteur Linky et un espace client Enedis pour pouvoir utiliser ce module
- Installez Node.js sur votre machine. La version minimale supportée est Node 16.
- Ouvrez un terminal
- Installez
linkyavecnpm:
npm i -g linkyAvant toute chose, il faudra vous connecter à votre espace client Enedis et leur donner l'autorisation de partager vos données avec une application extérieure
Rendez-vous sur conso.boris.sh pour donner votre accord et récupérer un token
Puis, créez une connexion à votre compte avec la commande suivante :
linky auth --token <votre-token>Une fois votre token sauvegardé, vous pourrez récupérer votre consommation quotidienne, votre courbe de charge (consommation par demi-heure), et votre consommation maximale par jour
# RĂ©cupĂšre la consommation quotidienne du 1er au 3 mai 2023
linky daily --start 2023-05-01 --end 2023-05-04
# RécupÚre la puissance moyenne consommée le 1 mai 2023, sur un intervalle de 30 min
linky loadcurve --start 2023-05-01 --end 2023-05-02
# RĂ©cupĂšre la puissance maximale de consommation atteinte quotidiennement du 1er au 3 mai 2023
linky maxpower --start 2023-05-01 --end 2023-05-04Si vous produisez de l'électricité, vous pouvez également récupérer votre production quotidienne et votre courbe de charge (production par demi-heure)
# RĂ©cupĂšre la production quotidienne du 1er au 3 mai 2023
linky dailyprod --start 2023-05-01 --end 2023-05-04
# RĂ©cupĂšre la puissance moyenne produite le 1 mai 2023, sur un intervalle de 30 min
linky loadcurveprod --start 2023-05-01 --end 2023-05-02En l'absence des paramÚtres --start et --end, vous récupérez la consommation / production / puissance de la veille
# RécupÚre la consommation de la journée d'hier
linky daily
# RécupÚre la puissance moyenne consommée pendant la journée d'hier, sur un intervalle de 30 min
linky loadcurve
# RécupÚre la puissance maximale de consommation atteinte durant la journée d'hier
linky maxpower
# RécupÚre la production de la journée d'hier
linky dailyprod
# RécupÚre la production moyenne consommée pendant la journée d'hier, sur un intervalle de 30 min
linky loadcurveprodSi votre token donne accÚs aux données de plusieurs PRMs, vous pouvez préciser le numéro de PRM à utiliser dans chaque commande avec le paramÚtre --prm
# RĂ©cupĂšre la consommation de la veille pour le compteur 111222333
linky daily --prm 111222333
# RĂ©cupĂšre la production de la veille pour le compteur 777888999
linky dailyprod --prm 777888999Si vous possédez plusieurs tokens, vous pouvez passer l'étape d'authentification et préciser le token à utiliser dans chaque commande avec le paramÚtre --token
# RĂ©cupĂšre la consommation de la veille avec le token aaa.bbb.ccc
linky daily --token aaa.bbb.ccc
# RĂ©cupĂšre la production de la veille avec le token xxx.yyy.zzz
linky dailyprod --token xxx.yyy.zzzVous pouvez changer le format d'affichage de sortie grĂące au paramĂštre --format
Les formats disponibles sont json, csv et pretty (par défaut)
linky daily --start 2023-05-01 --end 2023-05-02 --format jsonVous pouvez sauvegarder vos résultats dans un fichier en combinant les paramÚtres --output et --format
# Sauvegarde la courbe de charge de la veille au format JSON
linky loadcurve --output chemin/vers/ma_conso.json --format json
# Sauvegarde une semaine de consommation au format CSV
linky daily --start 2023-05-01 --end 2023-05-07 --output chemin/vers/ma_conso.csv --format csvVous pouvez masquer les messages et animations de progression grùce au paramÚtre --quiet afin de faciliter l'intégration dans des scripts
linky maxpower --quiet --format json | jq '.interval_reading[0].value'Pour voir l'aide détaillée et plus d'exemples :
linky --help# Depuis un projet Node.js
npm i linkyimport { Session } from 'linky';
// Créez une session à partir du token
const token = 'xxx.yyy.zzz';
let session = new Session(token);
// Si le token permet d'accéder à plusieurs PRMs, vous pouvez préciser celui à utiliser
const prm = '123456';
session = new Session(token, prm);
// Si vous prévoyez de rendre votre application/service/module accessible au grand public,
// ajoutez un User-Agent au format string Ă la session.
// Celui-ci doit permettre d'identifier l'origine des requĂȘtes envoyĂ©es Ă Conso API.
session.userAgent = 'Mon super service';
// RĂ©cupĂšre la consommation quotidienne du 1er au 3 mai 2023
session.getDailyConsumption('2023-05-01', '2023-05-04').then((result) => {
console.log(result);
/*
{
"reading_type": {
"unit": "Wh",
"measurement_kind": "energy"
},
"interval_reading": [
{ "value": "12873", "date": "2023-05-01" },
{ "value": "12296", "date": "2023-05-02" },
{ "value": "14679", "date": "2023-05-03" }
]
...
*/
});
// RécupÚre la puissance moyenne consommée le 1er mai 2023, sur un intervalle de 30 min
session.getLoadCurve('2023-05-01', '2023-05-02').then((result) => {
console.log(result);
/*
{
"reading_type": {
"unit": "W",
"measurement_kind": "power"
},
"interval_reading": [
{ "value": "752", "date": "2023-05-01 00:30:00" },
{ "value": "346", "date": "2023-05-01 01:00:00" },
{ "value": "250", "date": "2023-05-01 01:30:00" },
...
*/
});
// RĂ©cupĂšre la puissance maximale de consommation atteinte quotidiennement du 1er au 3 mai 2023
session.getMaxPower('2023-05-01', '2023-05-04').then((result) => {
console.log(result);
/*
{
"reading_type": {
"unit": "VA",
"measurement_kind": "power"
},
"interval_reading": [
{ "value": "4638", "date": "2023-05-01 12:06:20" },
{ "value": "4410", "date": "2023-05-02 19:27:46" },
{ "value": "3570", "date": "2023-05-03 21:42:12" }
]
...
*/
});
// RĂ©cupĂšre la production quotidienne du 1er au 3 mai 2023
session.getDailyProduction('2023-05-01', '2023-05-04').then((result) => {
console.log(result);
/*
{
"reading_type": {
"unit": "Wh",
"measurement_kind": "energy"
},
"interval_reading": [
{ "value": "12873", "date": "2023-05-01" },
{ "value": "12296", "date": "2023-05-02" },
{ "value": "14679", "date": "2023-05-03" }
]
...
*/
});
// RĂ©cupĂšre la puissance moyenne produite le 1er mai 2023, sur un intervalle de 30 min
session.getProductionLoadCurve('2023-05-01', '2023-05-02').then((result) => {
console.log(result);
/*
{
"reading_type": {
"unit": "W",
"measurement_kind": "power"
},
"interval_reading": [
{ "value": "752", "date": "2023-05-01 00:30:00" },
{ "value": "346", "date": "2023-05-01 01:00:00" },
{ "value": "250", "date": "2023-05-01 01:30:00" },
...
*/
});
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent