Edge Device Local API Docs
Local Control of Load Management [Rest API]

To activate the API server, please contact [email protected]
The API returns an HTTP status code 500 (Internal Server Error) if certain fields are incorrect or invalid. 
Good to know:
Ensure that all required fields are correctly formatted and validated to avoid this error. 
If you only want to read measuring data locally, you're in the wrong place—you need the Realtime energy data [Modbus TCP]﻿ .
﻿
Provides live updated values of the consumption and status of the load CLM.
GET
Request
Header Parameters
Authorization
String
required
user and password encoded in base64 following basic auth specification
Curl
Node.js
JS
Python
Ruby
curl --location --globoff 'https://[edge_device_ip]:7000/v1/live/data' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'
curl --location --globoff 'https://[edge_device_ip]:7000/v1/live/data' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'
Responses
200
{
    "ActualActivePower": "float", // active power measured by the edge device in W
    "ActualReactivePower": "float", // reactive power measured by the edge device in VAR
    "ActualCurrentL1": "float", // current measured by the edge device on phase L1 in A
    "ActualCurrentL2": "float", // current measured by the edge device on phase L2 in A
    "ActualCurrentL3": "float", // current measured by the edge device on phase L3 in A
    "ActualCurrentSum": "float", // current measured by the edge device, sum over all phases in A
    "Status": "string", // aggregated status of all the EVSE controlled by the CLM
}
{
    "ActualActivePower": "float", // active power measured by the edge device in W
    "ActualReactivePower": "float", // reactive power measured by the edge device in VAR
    "ActualCurrentL1": "float", // current measured by the edge device on phase L1 in A
    "ActualCurrentL2": "float", // current measured by the edge device on phase L2 in A
    "ActualCurrentL3": "float", // current measured by the edge device on phase L3 in A
    "ActualCurrentSum": "float", // current measured by the edge device, sum over all phases in A
    "Status": "string", // aggregated status of all the EVSE controlled by the CLM
}
﻿
Return current API settings
GET
Request
Header Parameters
Authorization
String
required
user and password encoded in base64 following basic auth specification
Curl
Node.js
JS
Python
Ruby
curl --location --globoff 'https://[edge_device_ip]:7000/v1/flex_management_settings' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'
curl --location --globoff 'https://[edge_device_ip]:7000/v1/flex_management_settings' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'
Responses
200
{
    "ActivePowerActivation": "bool", // true if cascading is enabled otherwise false
    "FallbackCurrentLimit": "float", // current limit if keep alive endpoint is not called every 120 sec (default)
    "CurrentLimit": "float", // LM current limit that is configured currently
    "RunState": True, // [TBD by SmartGridready] currently alwasy true
    "ReadinessState": True, // [TBD by SmartGridready] currently alwasy true
    "MaxActivePower": 0.0, // [TBD by SmartGridready] currently alwasy 0.0
    "MinActivePower": 0.0, // [TBD by SmartGridready] currently alwasy 0.0
}
{
    "ActivePowerActivation": "bool", // true if cascading is enabled otherwise false
    "FallbackCurrentLimit": "float", // current limit if keep alive endpoint is not called every 120 sec (default)
    "CurrentLimit": "float", // LM current limit that is configured currently
    "RunState": True, // [TBD by SmartGridready] currently alwasy true
    "ReadinessState": True, // [TBD by SmartGridready] currently alwasy true
    "MaxActivePower": 0.0, // [TBD by SmartGridready] currently alwasy 0.0
    "MinActivePower": 0.0, // [TBD by SmartGridready] currently alwasy 0.0
}
﻿
Update API settings
POST
Request
Header Parameters
Authorization
String
required
user and password encoded in base64 following basic auth specification
Body Parameters
ActivePowerActivation
Boolean
optional
enable or disable LM controll over API
CurrentLimit
Number
optional
load management current limit
FallbackCurrentLimit
Number
optional
limit if keep alive endpoint is not called every 120 sec (default)
Curl
Node.js
JS
Python
Ruby
import requests
import json

url = "https://[edge_device_ip]:7000/v1/flex_management_settings"

payload = json.dumps({
   "ActivePowerActivation": "Boolean",
   "CurrentLimit": "Number",
   "FallbackCurrentLimit": "Number"
})
headers = {
   'Accept': 'application/json',
   'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

import requests
import json

url = "https://[edge_device_ip]:7000/v1/flex_management_settings"

payload = json.dumps({
   "ActivePowerActivation": "Boolean",
   "CurrentLimit": "Number",
   "FallbackCurrentLimit": "Number"
})
headers = {
   'Accept': 'application/json',
   'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)
Responses
200

﻿
This endpoint resets the internal timeout and prevents the CLM to enter into the fallback current limit mode. This endpoint should be called at least once every 120 seconds (default).
POST
Request
Header Parameters
Authorization
String
required
user and password encoded in base64 following basic auth specification
Curl
Node.js
JS
Python
Ruby
curl --location --globoff --request POST 'https://[edge_device_ip]:7000/v1/keep_alive' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'
curl --location --globoff --request POST 'https://[edge_device_ip]:7000/v1/keep_alive' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json'
Responses
200

﻿
﻿
Get measurement data
Realtime energy data [Modbus TCP]