| GET | /api/v6/meteringpoints/{Ean}/graph/{Aggregation}/{DateFrom}/{DateTo} | Get usages based on aggregation starting from DateFrom to endDate |
|---|
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Ean | path | EAN (18 numbers) | Yes | Request of details of specific meteringpoint with Ean |
| Aggregation | path | Enum | Yes | Aggregation level. The None-'level' will give the most detailed level available for the requested asset. If a level is requested that is not available or can be calculate, no data is returned. Enum options: None, Hour, Day, Week, Month |
| DateFrom | path | Date: yyyy-mm-dd | Yes | Start date the usages are requested for |
| DateTo | path | Date: yyyy-mm-dd | Yes | End date the usages are requested for (this is included in the response). If no date is provided the DateTo will seven days from the DateFrom. |
| CalculateMissingUsages | query | Boolean | No | calculate the usage of that period and divide it over the missing hours or 15 minute periods, but this can be calculated (Default: false) |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| ApiKey | form | String | Yes | Api-key. Used to provide credentials to the api. Can also be provided through the request headers with key: X-API-KEY |
| OnlyPayload | form | Boolean | No | Normally the result of the request is put inside a resultobject with some status information about the request. If you want the output as csv this outer object can be irritating. Default value: FALSE |
| ShowRequest | form | Boolean | No | Show the request as interpreted by the api. Useful to see how filters / dates are parsed. If no value us provided, the default value is: FALSE |
| DateTimeFormat | form | Enum | No | Format all DateTime in the response object. If used in browser, sometimes ISO8601 is not correctly transformed. Enum options: ISO8601 (DEFAULT), UTC, NL, NLOffset, Unix, UnixMillis |
| ISO8601 | |
| UTC | |
| NL | |
| NLOffset | |
| IN | |
| INOffset | |
| Unix | |
| UnixMillis |
| None | |
| Hour | |
| Day | |
| Week | |
| Month | |
| Year |
To override the Content-type in your clients, use the HTTP Accept Header, append the .csv suffix or ?format=csv
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
GET /api/v6/meteringpoints/{Ean}/graph/{Aggregation}/{DateFrom}/{DateTo} HTTP/1.1
Host: p4v8.smartdatasolutions.nl
Accept: text/csv