Huawei FusionSolar Northbound API: แนวทางเชื่อมระบบภายนอก.

FusionSolar Northbound API เป็นช่องทางสำหรับเชื่อมข้อมูลจาก Huawei FusionSolar/SmartPVMS ไปยังระบบภายนอก เช่น Data Pipeline, Dashboard หรือระบบ Monitoring กลาง แต่ API ของ Huawei มีบริบทเรื่องสิทธิ์บัญชี, Region/Management System และเวอร์ชันเอกสารที่ต้องแยกออกจากกันให้ชัดเจน

บทความนี้จึงใช้ข้อมูลปัจจุบันสำหรับเรื่องบัญชีและสิทธิ์ และใช้ Interface Reference แบบระบุเวอร์ชันสำหรับรายละเอียดระดับ Endpoint โดยไม่อ้างว่า contract เดียวกันใช้ได้กับทุก Region หรือทุก deployment

หากเป้าหมายคือดู Plant, Energy Flow, Battery, Charger, Optimizer หรือ Alarm ในระบบปกติ ให้เริ่มที่ Huawei FusionSolar Cloud & App Guide ก่อน หน้านี้เน้นเฉพาะการดึงข้อมูลออกไปยังระบบภายนอกผ่าน Northbound API

Integration Flow

ภาพรวมระบบแยกเป็นขั้นตอนแบบนี้ได้:

FusionSolar / SmartPVMS
        ↓
Northbound credentials / permissions
        ↓
Authentication + session/token handling
        ↓
Station / Device / KPI data
        ↓
Normalization + cache
        ↓
Our API / Database / Dashboard

แนวทางนี้ช่วยให้เรื่องสิทธิ์, Session และการเก็บข้อมูลแยกออกจาก UI ของ Dashboard ชัดเจน

Account และ Permission มาก่อน Code

API ไม่ได้เริ่มจากการเขียนโค้ดทันที ผู้ใช้งานต้องมีบัญชีและสิทธิ์ที่เหมาะสมก่อน ถ้า Installer มองไม่เห็นเมนูสมัคร Northbound API ควรตรวจ Role/Company Administrator ก่อนเสียเวลา Debug ฝั่ง Client

Huawei FusionSolar SmartPVMS FAQ ที่ตรวจสอบในเดือนตุลาคม 2569 ระบุว่า การสมัครใช้ Northbound API ต้องดำเนินการโดย Company Administrator หาก Installer ไม่พบเมนูสมัคร API ต้องติดต่อผู้ดูแลบริษัทเพื่อเปิดใช้งานตามสิทธิ์ที่กำหนด

อีก FAQ ของ Huawei ระบุว่า ณ เวลาที่ตรวจสอบ ไม่มีการจำกัดจำนวน Plant ที่ Northbound API account หนึ่งบัญชีสามารถจัดการได้ ทั้งสองข้อควรถือเป็นข้อมูลปัจจุบันที่ต้องตรวจซ้ำหาก Huawei เปลี่ยนนโยบายในอนาคต

Huawei ยังมี FusionSolar App User Manual Issue 08 (2026-06-30) ที่อธิบายขั้นตอนให้ Installer สมัคร Company Administrator role เมื่อบริษัทย่อยยังไม่มี Company Administrator อยู่แล้ว ซึ่งช่วยยืนยันบริบทสิทธิ์ผู้ใช้ในเวอร์ชันปัจจุบัน แต่ไม่ได้ทำให้ Northbound endpoint contract รุ่นเก่ากลายเป็นเอกสารล่าสุดโดยอัตโนมัติ

แหล่งอ้างอิง:

• Huawei FusionSolar SmartPVMS FAQ — Northbound API application
• Huawei FusionSolar SmartPVMS FAQ — Northbound API account plant limit
• Huawei — FusionSolar App User Manual
• Huawei SmartPVMS FAQ — viewing enabled Northbound APIs

ตรวจ Region และ Interface ที่บัญชีเปิดจริงก่อน

FusionSolar มี Management System หลายโดเมนตามภูมิภาค และ Huawei ระบุในคู่มือปี 2026 ว่ารายการโดเมนสามารถเปลี่ยนได้ เช่น intl.fusionsolar.huawei.com, sg5.fusionsolar.huawei.com, eu5.fusionsolar.huawei.com และโดเมนเฉพาะภูมิภาคอื่น ๆ ดังนั้น Client ไม่ควร hard-code สมมติฐานว่า account ทุกแห่งใช้ Domain เดียวกัน

ในฝั่ง SmartPVMS ผู้ดูแลบริษัทควรตรวจเมนู Northbound Management/Interface List ของบัญชีที่ใช้งานจริง และยึด Interface Reference ที่ระบบนั้นให้มาสำหรับ Endpoint, Parameter, Rate Limit และ Error Code ของ deployment นั้น ๆ

แนวทางนี้ทำให้เราแยกได้ชัดว่าอะไรคือ ข้อมูลบัญชีปัจจุบัน และอะไรคือ ตัวอย่าง contract จากเอกสารเวอร์ชันหนึ่ง

Authentication และ Session

Client ควรมีชั้นที่รับผิดชอบเรื่อง Authentication/Session โดยเฉพาะ ไม่ควรกระจาย Login หรือ Token handling ไปตามส่วนต่าง ๆ ของแอป

Huawei มีเอกสาร SmartPVMS V600R024C00 Northbound Interface Reference V6 ที่อธิบาย Login Interface ไว้ชัดเจนสำหรับเวอร์ชันนั้น:

• POST https://{management-system-domain}/thirdData/login
• Request ใช้ userName และ systemCode
• เมื่อล็อกอินสำเร็จ ระบบส่ง XSRF-TOKEN กลับมาใน Response Header
• เอกสารระบุอายุ Token 30 นาที และสามารถใช้ Token เดิมซ้ำได้ก่อนหมดอายุ
• Login ถูกจำกัดไว้ 5 ครั้งต่อ 10 นาทีต่อ Northbound user และระบุ error code 407 เมื่อเกินข้อจำกัด
• หากใส่รหัสผ่านผิด 5 ครั้งภายใน 10 นาที บัญชีจะถูกล็อก 30 นาทีตามเอกสารเวอร์ชันนี้

แหล่งอ้างอิง: Huawei — SmartPVMS V600R024C00 Northbound Interface Reference V6: Login Interface

ข้อสำคัญคือเอกสารนี้เป็น version-specific reference และอัปเดตในปี 2023 จึงไม่ควรตีความว่า Endpoint, Token lifetime หรือข้อจำกัดทุกอย่างเหมือนกันในทุก Region/Deployment/Version หลังจากนั้น ก่อนนำไปใช้ Production ต้องเทียบกับ Interface Reference ที่บัญชี/Region ของเรามองเห็นจริงอีกครั้ง

Asset discovery กับ KPI data

แนวทางเชิงสถาปัตยกรรมที่ยังมีประโยชน์คือแยกข้อมูลที่เปลี่ยนไม่บ่อย เช่นรายชื่อ Plant/Device ออกจากข้อมูล KPI ที่ต้องอ่านเป็นช่วง ๆ แล้วทำ Cache/Normalization ก่อนส่งต่อไปยัง Dashboard หรือระบบแจ้งเตือน

Rate Limit และ Resilience

สิ่งที่ยืนยันได้จาก Login Interface V600R024C00 คือ Login มี Traffic Limit 5 ครั้งต่อ 10 นาทีต่อ Northbound user แต่ข้อจำกัดของ Data Endpoint แต่ละตัวไม่ควรถูกยกจากบทความเก่ามาใช้เป็นค่าปัจจุบันจนกว่าจะตรวจ Interface Reference ของเวอร์ชันที่ใช้งานจริง

Client จึงควรออกแบบให้รองรับ:

• Throttling แยก Login กับ Data API
• Retry/Backoff โดยไม่วน Login ซ้ำจนชน Lockout
• Session/Token expiry
• Partial upstream failure
• Logging ของเวลาที่ดึงข้อมูลล่าสุดสำเร็จและเวอร์ชัน API/Region ที่ใช้งาน

ทิศทางต่อยอด

ถ้าจะนำ FusionSolar ไปใช้ในระบบจริง ควรแยก Vendor-specific logic ไว้หลัง Interface กลาง และทำ Lab ที่ระบุ Region, Interface Reference, เวอร์ชัน และข้อมูลที่ทดสอบจริงก่อนต่อยอดเป็น Project/App สำหรับ Solar Monitoring หลายผู้ผลิต