List monthly deltas of an entity - Enectiva REST API

This action allows to list monthly deltas of a single entity. Entity is any
organizational unit in Enectiva, e.g. a building, a complex, a factory. Values
are in the default unit of the corresponding energy. The values can
be sorted, the default order is chronological.

The response is limited to 1000 records. If you need more records, you can use
the filter query parameter to traverse all the available data (you can get
more details about it in the related section Filters).

The time of each record is the first second of the month. The value is a delta
for that whole month (or up to the last valid reading). The time does not
contain offset information. If the meters contributing to the delta of this
object span multiple time zones, the presented value is the sum of groups of
meters sharing one time zone where the time range is interpreted in the local
time.

Example: a portfolio with one building in Dover (Europe/London) and one
building in Calais (Europe/Paris) will report total delta for January as

the delta in Dover between yyyy-01-01T00:00:00Z and yyyy-01-31T00:00:00Z plus

the delta in Calais between yyyy-01-01T00:00:00+01:00 and yyyy-01-32T00:00:
00+01:00.

Not as a delta over the same time window (coinciding with the month) in one or
the other time zone.

The required scope is entity_deltas.

Access via Access token, with the source accessibility determined by the permissions of the customer associated with the token and the Login token scopes used to obtain it

JWT Bearer

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/vnd.api+json

Body

Example

{
    "data": [
        {
            "id": "e_3385_el_month_201801010000",
            "attributes":{
                "time": "2018-01-01T00:00:00.000",
                "value": 101.922047999983,
                "unit": "kWh"
            },
            "type": "entity_deltas"
        },
        {
            "id": "e_3385_el_month_201802010000",
            "attributes":{
                "time": "2018-02-01T00:00:00.000",
                "value": 92.0586239999852,
                "unit": "kWh"
            },
            "type": "entity_deltas"
        },
        {
            "id": "e_3385_el_month_201803010000",
            "attributes":{
                "time": "2018-03-01T00:00:00.000",
                "value": 101.785055999983,
                "unit": "kWh"
            },
            "type": "entity_deltas"
        }
    ]
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠406Not Acceptable

🟠429Too Many Requests

🔴500Server Error