1. EMS
FoxCloud OpenAPI
Full API Reference
  • Vpp Flow
  • Full API Reference
  • Power Station
    • Get power station list
      POST
    • Get power station detail
      GET
    • Create power station
      POST
    • Delete power station
      POST
    • Edit power station
      POST
  • VPP
    • authorization code mode offboard by sn
      POST
    • client mode offboard
      POST
    • client mode onboard
      POST
  • Inverter-V1
    • Get device setting capabilities
      POST
    • Read device settings
      POST
    • Write device settings
      POST
    • Get device detail
      GET
    • Get device real-time data
      POST
  • Inverter
    • Get device list
    • Get device detail (Deprecated)
    • Get available variables
    • Get error code information
    • Get device real-time data (Deprecated)
    • Get device history data
    • Get device production report
    • Get device power generation
    • Get the minimum soc settings for the battery of device
    • Set the minmum soc for the battery of the device
    • Get the setting of battery charging time
    • Set the battery charging time
    • Get the device settings item
    • Set the device settings item
    • Get the device time
    • Set the device time
    • Get the device peakshaving settings
    • Set the device peakshaving settings
    • Get the Meter Reader
    • Set the Meter Reader
    • Get battery heating Parameter
    • Set battery heating Parameter
    • Get display sleep Paeameter
    • Set display sleep Paeameter
    • Get the device third party PV Integration status
    • Get Device Fault History
    • Get device PV power generation
  • Scheduler-V3
    • Get the time segment information
    • Set the time segment information
    • Batch set the time segment information
  • Scheduler-V2
    • Get the time segment information
    • Set the time segment information
  • Scheduler-V1
    • Get the main switch status
    • Set the main switch status
    • Get the time segment information
    • Set the time segment information
  • Scheduler (Deprecated)
    • Get the main switch status (Deprecated)
    • Get the time segment information (Deprecated)
    • Set the main switch status (Deprecated)
    • Set the time segment information (Deprecated)
  • Data Logger
    • Get Data Logger list
    • Get Data Logger Details
    • Get Data Logger Signal
    • Get Data Logger Wifi Info
    • Get Data Logger Lan Info
  • EMS
    • Get Ems list
      POST
    • Get Ems real-time data
      POST
    • Get Ems history data
      POST
    • Get Ems System Setting
      GET
    • Set Ems System Setting
      POST
    • Get Ems Rate Setting
      POST
    • Set Ems Rate Setting
      POST
    • Set Ems Ac Output Control Setting
      POST
    • Get Ems Ac Output Control Setting
      GET
    • Set Ems Power Limit Control Setting
      POST
    • Get Ems Power Limit Control Setting
      GET
    • Set Ems More Setting
      POST
    • Get Ems More Setting
      GET
    • Set Ems Gen Setting
      POST
    • Get Ems Gen Setting
      GET
  • Meter
    • Get meter list
    • Get the device settings item
    • Set the device settings item
  • Heat
    • genericControlsGet
    • genericControlsSet
    • heatingControlsGet
    • heatingControlsSet
    • heatingCircuitsControlsGet
    • heatingCircuitsControlsSet
    • dhwControlsGet
    • dhwControlsSet
    • heatAssetList-OAuth flow unsupported
    • changeKafkaPushStatus-OAuth flow unsupported
  • Schemas
    • CapabilityRequest
    • batteryList
    • HeatAssetListParam
    • CapabilityResponse
    • Result
    • CapabilityResult
    • CapabilityGroup
    • WeComLoginRequest
    • CapabilityField
    • ResponseInfo
    • ValueRange
    • Holiday
    • SettingGetRequest
    • DailyTimer
    • SettingGetResponse
    • GenericControlsData
    • SettingGetResult
    • GenericControlsParam
    • SettingSetRequest
    • WeekTimerItem
    • SettingSetResponse
    • HeatingControlsData
    • HeatingControlsParam
    • CircuitActivation
    • CircuitType
    • HeatingCircuitsControlsParam
    • DhwControlsData
    • DhwControlsParam
    • HolidayAway
    • HolidayHome
    • HeatKafkaPushStatusParam
    • TimerItem
    • DailyTimerTimerItem
    • DhwTimerItem
    • DailyTimerDhwTimerItem
    • TimerItem
    • DailyTimer
    • WeeklyTimer
    • DailyTimerTimerItem
    • BivalencePoint
    • DhwTimerItem
    • AuxiliaryHeaterSettings
    • DailyTimerDhwTimerItem
    • WeeklyTimerWeekTimerItem
    • BaseWeekTimerItem
    • WeeklyTimerBaseWeekTimerItem
    • CureSetting
    • HeatingCurves
    • HeatingCircuitsControlsData
    • TimerItem
    • DailyTimer
    • BivalencePoint
    • AuxiliaryHeaterSettings
  1. EMS

Get Ems real-time data

POST
/op/v0/ems/real/query
Get the latest real-time data of the inverter. The sn array is mandatory and returns only the result set belonging to the current user. If no variable is specified, all variables are queried
request body example:
{
  "sns": ["***************","***************","***************"],
  "variables": ["totalFeedinPower","totalLoadsPower"]
}

Request

Authorization
Header Params

Body Params application/json

Example
{
    "variables": [
        "totalPVPower"
    ],
    "sns": [
        "string"
    ]
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/op/v0/ems/real/query' \
--header 'token;' \
--header 'signature;' \
--header 'timestamp;' \
--header 'lang: en' \
--header 'Content-Type: application/json' \
--data '{
    "variables": [
        "totalPVPower"
    ],
    "sns": [
        "string"
    ]
}'

Responses

🟢200成功
application/json
Bodyapplication/json

Example
{
    "errno": 0,
    "result": [
        {
            "emsSN": "string",
            "time": "string",
            "datas": [
                {
                    "variable": "string",
                    "unit": "string",
                    "name": "string",
                    "value": "string"
                }
            ]
        }
    ]
}
Modified at 2026-08-05 03:23:44
Previous
Get Ems list
Next
Get Ems history data
Built with