** THIS NODE IS NO LONGER MAINTAINED **
UPDATE 1 nov 2021: Mind the power station ID!
The Goodwe PV solar panel inverters come with a webportal which show all it's performance. This Node-RED flow outputs a (small) part of the data available from the Goodwe API. It's using the version 2 API.
Outputs from this flow include:
- fysical address of the converter,
- name of the station,
- total power generated and
- power generated today.
Much more data is readily available.
In the fuction nodes the flow needs these inputs:
- The loginname to the portal,
- The corresponding password (both set in the "Get ID token"-function node).
- The power station ID, as found in the URL when logged into the portal.
The power station ID is set in the "Get station output"-function node. To find the ID for your installation, login to the normal SEMS webportal. Once logged in, the last part of the URL in your webbrowser is the ID. Copy this part into the script for the variable "psid".
Among other sources, this helped most: DiedB/Homey-SolarPanels#28 (comment)
The first HTTP API call returns a session login token ID. This token is used in the second call, which returns all data. It seems the word "token" is used differently throughout the API, which can be confusing. The token is session-bound and expires in ? time. Replies from the "Request station" call can be delayed upto 10-ish seconds.
Hey Did a bit of an update for you as they have moved the portal to the new API and different structure. Here is the JSON below
[{"id":"e82b4b0.2a922b8","type":"tab","label":"Query SEMS portal for Goodwe Inverter","disabled":false,"info":""},{"id":"547c4204.8607bc","type":"debug","z":"e82b4b0.2a922b8","name":"Token Details","active":false,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","targetType":"full","statusVal":"","statusType":"auto","x":720,"y":240,"wires":[]},{"id":"7f1daadf.2b67bc","type":"http request","z":"e82b4b0.2a922b8","name":"Request token","method":"POST","ret":"obj","paytoqs":"ignore","url":"","tls":"","persist":false,"proxy":"","authType":"","x":480,"y":240,"wires":[["547c4204.8607bc","4865906.e8143f"]]},{"id":"6a0ae223.adb52c","type":"function","z":"e82b4b0.2a922b8","name":"Get ID token from login","func":"// Credentials as used for login to the Semsportal at https://www.semsportal.com/\naccount = \"YourSEMSLoginNamehere";\npwd = \"YourSEMSPasswordhere\";\n\n// ---------- no changes needed below ----------------------------\nloginPayload = { 'account': account, 'pwd': pwd };\n\n// It's a given, likely from the API documentation?\ntoken = '{\"client\": \"ios\", \"version\": \"v2.1.0\", \"language\": \"en\"}';\n\nglobal_url = 'https://www.semsportal.com/api/';\nheaders = { 'token': token };\n\nmsg.url = global_url + \"v2/Common/CrossLogin\";\nmsg.headers = headers;\nmsg.payload = loginPayload;\n\nreturn msg;\n","outputs":1,"noerr":0,"initialize":"","finalize":"","libs":[],"x":430,"y":180,"wires":[["7f1daadf.2b67bc"]]},{"id":"dbd14dd3.8b8fe8","type":"inject","z":"e82b4b0.2a922b8","name":"","props":[{"p":"payload"},{"p":"topic","vt":"str"}],"repeat":"","crontab":"","once":false,"onceDelay":0.1,"topic":"","payload":"","payloadType":"date","x":220,"y":180,"wires":[["6a0ae223.adb52c"]]},{"id":"4865906.e8143f","type":"function","z":"e82b4b0.2a922b8","name":"Get station output","func":"// Power station ID can be found in the last part of the URL of the SEMSportlal, once logged in\npsid = '3d5ae67f-4126-49cf-a75b-c9f389db6112';\n\n\n// -------------- Generic below ---------------------------------\n\n// https://github.com/DiedB/Homey-SolarPanels/issues/28\n\n// Get the relevant response from the login call: \nvar uid = msg.payload.data.uid; // User ID\nvar id_token = msg.payload.data.token; // Time-bound token from login\nvar timestamp = msg.payload.data.timestamp;\n\n// Warning: The API uses 'token' with different meanings throughout the communication\ntoken = '{\"uid\": \"'+ uid + '\", \"timestamp\": '+ timestamp+ ', \"token\": \"'+ id_token + '\", \"client\": \"ios\", \"version\": \"v2.0.4\", \"language\": \"en\"}';\nheaders = { 'User-Agent': 'JH', 'Token': token }\n\nglobal_url = 'https://www.semsportal.com/api/'\nmsg.url = global_url + \"v2/PowerStation/GetMonitorDetailByPowerstationId\";\n\nmsg.headers = headers;\n\npayload = {'powerStationId': psid};\nmsg.payload = payload;\n\n\nreturn msg;\n","outputs":1,"noerr":0,"initialize":"","finalize":"","libs":[],"x":570,"y":300,"wires":[["391e2baf.eb6b34"]]},{"id":"efb25403.f9b5a","type":"debug","z":"e82b4b0.2a922b8","name":"Data","active":false,"tosidebar":true,"console":false,"tostatus":false,"complete":"payload","targetType":"msg","statusVal":"","statusType":"auto","x":890,"y":420,"wires":[]},{"id":"391e2baf.eb6b34","type":"http request","z":"e82b4b0.2a922b8","name":"Request station","method":"POST","ret":"obj","paytoqs":"ignore","url":"","tls":"","persist":false,"proxy":"","authType":"","x":620,"y":360,"wires":[["fedcd784.eee18","734da56e.753b6c","8901911b.bafe8"]]},{"id":"fedcd784.eee18","type":"function","z":"e82b4b0.2a922b8","name":"Get values","func":"// Get values as shown in the webportal:\n\n// Stationname, top left as displayed in the dropdown (not sure how more stations handle....?)\nvar station_name = msg.payload.data.info.stationname;\n\n// Fysical address\nvar address = msg.payload.data.info.address;\n\n\n// Total power als shown on the webportal left below today's production\nvar total_power = msg.payload.data.kpi.total_power;\n\n// Today's power als in the circle middle down the webportal main page\nvar day_power = msg.payload.data.kpi.power;\n\nmsg = {};\n\nmsg.payload = {'station_name': station_name, 'address': address, 'total_power': total_power, 'day_power': day_power};\n\nreturn msg;","outputs":1,"noerr":0,"initialize":"","finalize":"","libs":[],"x":710,"y":420,"wires":[["efb25403.f9b5a"]]},{"id":"734da56e.753b6c","type":"debug","z":"e82b4b0.2a922b8","name":"Station Info","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","targetType":"full","statusVal":"","statusType":"auto","x":830,"y":360,"wires":[]},{"id":"8901911b.bafe8","type":"change","z":"e82b4b0.2a922b8","name":"","rules":[{"t":"set","p":"payload","pt":"msg","to":"payload.data.inverter[0].d","tot":"msg"}],"action":"","property":"","from":"","to":"","reg":false,"x":730,"y":540,"wires":[["ac1129ba.0412e8"]]},{"id":"ac1129ba.0412e8","type":"debug","z":"e82b4b0.2a922b8","name":"Data","active":true,"tosidebar":true,"console":false,"tostatus":false,"complete":"true","targetType":"full","statusVal":"","statusType":"auto","x":910,"y":540,"wires":[]}]