linky
2.0.2
NB : لأن هذه الأداة مستهدفة للشعب الفرنسي ، فإن الوثائق هي ... باللغة الفرنسية
تتيح لك هذه الوحدة استرداد استهلاكك و API Croduction Viage
يمكن استخدامه بطريقتين:
لاحظ أنك بحاجة إلى عداد رابط ومنطقة عميل enedis لتتمكن من استخدام هذه الوحدة
linky مع npm : npm i -g linkyبادئ ذي بدء ، سيتعين عليك تسجيل الدخول إلى منطقة عميل enedis الخاصة بك ومنحهم إذنًا لمشاركة بياناتك مع تطبيق خارجي
انتقل إلى conso.boris.sh لإعطاء اتفاقك واسترداد رمز الرمز المميز
ثم قم بإنشاء اتصال بحسابك بالترتيب التالي:
linky auth --token < votre-token > بمجرد حفظ الرمز المميز الخاص بك ، يمكنك استرداد استهلاكك اليومي ، ومنحنى التحميل الخاص بك (الاستهلاك بمقدار نصف ساعة) ، والحد الأقصى للاستهلاك يوميًا
# 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-04إذا كنت تنتج الكهرباء ، يمكنك أيضًا استرداد إنتاجك اليومي ومنحنى التحميل الخاص بك (إنتاج كل نصف ساعة)
# 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-02 في غياب المعلمات --start و --end ، يمكنك استعادة الاستهلاك / الإنتاج / قوة اليوم السابق
# 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 loadcurveprod إذا كان الرمز المميز الخاص بك يتيح الوصول إلى بيانات عدة PRMS ، فيمكنك تحديد رقم PRM ليتم استخدامه في كل أمر مع المعلمة --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 777888999 إذا كان لديك العديد من الرموز ، فيمكنك اتخاذ خطوة المصادقة وتحديد الرمز المميز لاستخدامه في كل أمر مع المعلمة --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.zzz يمكنك تغيير تنسيق عرض الإخراج بفضل المعلمة --format
التنسيقات المتاحة هي json و csv و pretty (افتراضيًا)
linky daily --start 2023-05-01 --end 2023-05-02 --format json يمكنك حفظ نتائجك في ملف من خلال الجمع بين المعلمات --output و --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 csv يمكنك إخفاء رسائل التقدم والرسوم المتحركة بفضل المعلمة --quiet لتسهيل التكامل في البرامج النصية
linky maxpower --quiet --format json | jq ' .interval_reading[0].value 'لرؤية مساعدة مفصلة والمزيد من الأمثلة:
linky --help # Depuis un projet Node.js
npm i linky import { 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" },
...
*/
} ) ;
