محولات Sungrow التي تتم مراقبتها عبر واجهة برمجة التطبيقات المفتوحة iSolarCloud
الأجهزة المدعومة
| Device Type |
|---|
| جميع محولات الطاقة من Sungrow المسجلة في iSolarCloud |
خطوات التكوين
المتطلبات الأساسية: يجب أن يكون كل محول طاقة مضافًا بالفعل إلى حساب iSolarCloud الخاص بك ومرئيًا في البوابة الإلكترونية أو التطبيق المحمول.
-
جمع بيانات اعتماد API
تقدم لك iSolarCloud → الإعدادات → Open API:
مفتاح API، مفتاح الوصول، و مفتاح RSA. -
إنشاء مستخدم للقراءة فقط (مُوصى به)
في المستخدمون والأدوار أضف مستخدمًا مخصصًا باسم "API" وقيّد صلاحياته إلى قراءة. -
أضف المحرك في Sofar
-
التكاملات → إضافة جهاز
-
اختر iSolarCloud API
-
املأ الحقول:
الحقل المثال اسم المستخدم / كلمة المرور api_user / S3cureP@ssمفتاح API / مفتاح الوصول / مفتاح RSA القيم من الخطوة 1 مرشح الموقع 100;101(اختياري – قائمة مفصولة بفاصلة منقوطة)نوع الأمر الافتراضي (حد القدرة النشطة)
احفظ – سيظهر كل محول طاقة تابع للمواقع المختارة تلقائيًا.
-
المقاييس المعروضة
| المفتاح | الوصف | الوحدة |
|---|---|---|
actualPowerTot_W | القدرة المترددة اللحظية لمحطة الطاقة الشمسية | واط |
producedEnergyDeltaTot_Wh | طاقة المحطة الشمسية منذ القراءة السابقة ¹ | واط-ساعة |
importedEnergyDeltaTot_Wh | طاقة استيراد الشبكة (إذا وفرتها Sungrow) | واط-ساعة |
exportedEnergyDeltaTot_Wh | طاقة تصدير الشبكة (تغذية الشبكة) | واط-ساعة |
¹ يقوم المحرك بجمع الطاقة على مدى الوقت عند عدم توفر العدادات المطلقة بالكيلوواط-ساعة.
استكشاف الأخطاء وإصلاحها
- HTTP 401 / 403 – تحقق مرتين من بيانات اعتماد API وأن المستخدم لديه وصول API مُمكّن في iSolarCloud.
- لم يتم اكتشاف محولات طاقة – تحقق من قائمة معرف الموقع؛ اترك الحقل فارغًا لاسترجاع كل المحطات المرتبطة بالحساب.
- تم تجاهل تقليل القدرة – بعض إصدارات برنامج Sungrow القديمة لا تحترم حدود القدرة النشطة؛ غيّر وضع الأمر في المحرك إلى بديل (تشغيل/إيقاف) في الإعدادات.
الموارد المفيدة
- توثيق Open API – مرئي بعد تسجيل الدخول على
portal / Open API - الدعم الفني لـ Sungrow – service@sungrowpower.com
Last updated March 11, 2026Edit this page
