محولات Sungrow المراقبة عبر واجهة Open API الخاصة بـ iSolarCloud
الأجهزة المدعومة
| Device Type |
|---|
| All Sungrow inverters registered in iSolarCloud |
خطوات التكوين
المتطلب الأساسي: تمت إضافة كل محول بالفعل إلى حسابك في iSolarCloud، ويظهر في البوابة الإلكترونية أو تطبيق الهاتف المحمول.
-
اجمع بيانات اعتماد API
يوفر لك iSolarCloud → Settings → Open API ما يلي:
API Key وAccess Key وRSA Key. -
أنشئ مستخدمًا للقراءة فقط (موصى به)
في Users & Roles، أضف مستخدمًا مخصصًا باسم “API” وقيّد حقوقه بـ Read. -
أضف برنامج التشغيل في SmartgridOne
-
Integrations → Add device
-
اختر iSolarCloud API
-
املأ الحقول:
الحقل المثال Username / Password api_user / S3cureP@ssAPI Key / Access Key / RSA Key القيم من الخطوة 1 Location filter 100;101(اختياري – قائمة مفصولة بفواصل منقوطة)Command type الافتراضي (حد القدرة الفعالة)
احفظ – سيظهر تلقائيًا كل محول ينتمي إلى المواقع المحددة.
-
المقاييس المكشوفة
| المفتاح | الوصف | الوحدة |
|---|---|---|
| --------------------------- | ----------------------------------------------- | ---- |
actualPowerTot_W | القدرة اللحظية بالتيار المتردد لمحطة الطاقة الكهروضوئية | W |
producedEnergyDeltaTot_Wh | الطاقة الكهروضوئية منذ آخر قراءة ¹ | Wh |
importedEnergyDeltaTot_Wh | طاقة الاستيراد من الشبكة (إذا وفرتها Sungrow) | Wh |
exportedEnergyDeltaTot_Wh | طاقة التصدير إلى الشبكة (التغذية) | Wh |
¹ يدمج برنامج التشغيل القدرة بمرور الوقت عند عدم توفر عدادات kWh المطلقة.
استكشاف الأخطاء وإصلاحها
- HTTP 401 / 403 – تحقق مرة أخرى من بيانات اعتماد API ومن تمكين API access للمستخدم في iSolarCloud.
- لم يتم اكتشاف أي محولات – تحقق من قائمة location ID؛ واترك الحقل فارغًا لجلب كل المحطات المرتبطة بالحساب.
- تم تجاهل تقليص القدرة – لا تدعم بعض البرامج الثابتة القديمة من Sungrow حدود القدرة الفعالة؛ بدّل برنامج التشغيل إلى وضع الأوامر Alternative (ON/OFF) في الإعدادات.
موارد مفيدة
- توثيق Open API – يظهر بعد تسجيل الدخول على
البوابة / Open API - الدعم الفني من Sungrow – service@sungrowpower.com
Last updated March 10, 2026Edit this page