| GET | /v8/readings-bulk | ||
|---|---|---|---|
| GET | /v8/readings-bulk/{from} |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| From | path | Time stamp with format: yyyyMMdd-HHmmss-ffffff | No | If not given, the first object is given after the last request, otherwise gives the first ... data objects received from EDSN/Grid operator received after the given time stamp. Keep in mind, the time stamp is related to when SDS received the data from EDSN, not the date of the data itself! |
| IncludeIntervalObjects | query | Boolean, default: true | No | Include received interval objects in the result |
| IncludeDayObjects | query | Boolean, default: false | No | Include received day objects in the result |
| ObjectFilter | query | Enum: None, Hour, Day, LastDayOnly, Month | No | Gives option to filter return objects, for example to get always only hour records or day records |
| 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 |
| None | |
| Hour | |
| Day | |
| LastDayOnly | |
| Month |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Message | form | string | No | |
| TimeStamp | form | string | Yes | |
| DayObjectCount | form | int? | No | |
| IntervalObjectCount | form | int? | No | |
| RejectionObjectCount | form | int? | No | |
| DayObjects | form | List<P4ReadingDay> | No | |
| IntervalObjects | form | List<P4ReadingInterval> | No | |
| RejectionObjects | form | List<P4Rejection> | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Ean | form | string | No | |
| MeterId | form | string | No | |
| QueryDate | form | DateOnly | No | |
| MeasureUnit | form | string | No | |
| R180 | form | decimal? | No | |
| R181 | form | decimal? | No | |
| R182 | form | decimal? | No | |
| R280 | form | decimal? | No | |
| R281 | form | decimal? | No | |
| R282 | form | decimal? | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Ean | form | string | No | |
| MeterId | form | string | No | |
| QueryDate | form | DateOnly | No | |
| MeasureUnit | form | string | No | |
| Items | form | List<P4ReadingIntervalItem> | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| DateTimeOffset | form | DateTimeOffset | No | |
| R180 | form | decimal | No | |
| R280 | form | decimal? | No |
| Name | Parameter | Data Type | Required | Description |
|---|---|---|---|---|
| Ean | form | string | No | |
| QueryDate | form | DateOnly | No | |
| QueryReason | form | string | No | |
| RejectionCode | form | string | No | |
| RejectionText | form | string | No |
To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
GET /v8/readings-bulk HTTP/1.1 Host: p4.smartdatasolutions.eu Accept: application/xml
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length
<P4ReadingsBulk xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/SDS.V8.APIs.P4.EU.ServiceModel.Types">
<DayObjectCount>0</DayObjectCount>
<DayObjects xmlns:d2p1="http://schemas.datacontract.org/2004/07/SDS.P4.Common.DTO.EDSN">
<d2p1:P4ReadingDay>
<d2p1:Ean>String</d2p1:Ean>
<d2p1:MeasureUnit>String</d2p1:MeasureUnit>
<d2p1:MeterId>String</d2p1:MeterId>
<d2p1:QueryDate xmlns:d4p1="http://schemas.datacontract.org/2004/07/System" />
<d2p1:R180>0</d2p1:R180>
<d2p1:R181>0</d2p1:R181>
<d2p1:R182>0</d2p1:R182>
<d2p1:R280>0</d2p1:R280>
<d2p1:R281>0</d2p1:R281>
<d2p1:R282>0</d2p1:R282>
</d2p1:P4ReadingDay>
</DayObjects>
<IntervalObjectCount>0</IntervalObjectCount>
<IntervalObjects xmlns:d2p1="http://schemas.datacontract.org/2004/07/SDS.P4.Common.DTO.EDSN">
<d2p1:P4ReadingInterval>
<d2p1:Ean>String</d2p1:Ean>
<d2p1:Items>
<d2p1:P4ReadingIntervalItem>
<d2p1:DateTimeOffset xmlns:d6p1="http://schemas.datacontract.org/2004/07/System">
<d6p1:DateTime>0001-01-01T00:00:00Z</d6p1:DateTime>
<d6p1:OffsetMinutes>0</d6p1:OffsetMinutes>
</d2p1:DateTimeOffset>
<d2p1:R180>0</d2p1:R180>
<d2p1:R280>0</d2p1:R280>
</d2p1:P4ReadingIntervalItem>
</d2p1:Items>
<d2p1:MeasureUnit>String</d2p1:MeasureUnit>
<d2p1:MeterId>String</d2p1:MeterId>
<d2p1:QueryDate xmlns:d4p1="http://schemas.datacontract.org/2004/07/System" />
</d2p1:P4ReadingInterval>
</IntervalObjects>
<Message>String</Message>
<RejectionObjectCount>0</RejectionObjectCount>
<RejectionObjects xmlns:d2p1="http://schemas.datacontract.org/2004/07/SDS.P4.Common.DTO.EDSN">
<d2p1:P4Rejection>
<d2p1:Ean>String</d2p1:Ean>
<d2p1:QueryDate xmlns:d4p1="http://schemas.datacontract.org/2004/07/System" />
<d2p1:QueryReason>String</d2p1:QueryReason>
<d2p1:RejectionCode>String</d2p1:RejectionCode>
<d2p1:RejectionText>String</d2p1:RejectionText>
</d2p1:P4Rejection>
</RejectionObjects>
<TimeStamp>String</TimeStamp>
</P4ReadingsBulk>