الأجهزة المدعومة
| Device Type | API |
|---|---|
| Alfen Battery Container (250 kWh – 2 MWh) | ✅ |

خطوات التهيئة
-
بيانات اعتماد API
- استخرج مفتاح API و معرف البطارية من بوابة Greener.
- هذه مطلوبة من “مدخلات المستخدم” الخاصة بالسائق.
-
إضافة الجهاز
- في التكاملات → إضافة جهاز اختر واجهة برمجة تطبيقات Greener للتحكم في بطارية Alfen.
- أدخل مفتاح API ومعرف البطارية كما هو موفر بالضبط.
- تأكيد → يظهر الحاوية مع حالة الشحن (SOC) والقدرة.
-
اختياري – التحكم في نقطة الضبط
عندما يتم تفعيل وضع الشبكة الذكية، يقوم السائق بإرسال نقطة ضبط ثابتة للقدرة
(إيجابية = شحن، سلبية = تفريغ) إلى
/control/batteries/<ID>/command/set_constant_power_setpoint.
المقاييس المعروضة
| المفتاح | الوصف | الوحدة |
|---|---|---|
actualPowerTot_W | قدرة البطارية (+ = تفريغ) | W |
stateOfCharge_frac | حالة الشحن (0–1) | – |
importedEnergyDeltaTot_Wh | الطاقة المشحونة Δ | Wh |
exportedEnergyDeltaTot_Wh | الطاقة المفرغة Δ | Wh |
استكشاف الأخطاء وإصلاحها
- 401 غير مصرح – تحقق من سلسلة مفتاح API (بدون مسافات، الطول الكامل).
- 404 على معرف البطا رية – تحقق من المعرف الدقيق
GREENER_XXX. - القدرة لا تتحديث – توفر واجهة برمجة تطبيقات Greener نقاط بيانات جديدة كل ~10 ثوانٍ؛
تأكد من السماح بحركة المرور الصادرة عبر HTTPS (443).
موارد مفيدة
- وثائق Greener –
https://www.greener.nu/en/batteries