<back to all web services

ReadingsBulk

The following routes are available for this service:
GET/v8/readings-bulk
GET/v8/readings-bulk/{from}
ReadingsBulk Parameters:
NameParameterData TypeRequiredDescription
FrompathTime stamp with format: yyyyMMdd-HHmmss-ffffffNoIf 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!
IncludeIntervalObjectsqueryBoolean, default: trueNoInclude received interval objects in the result
IncludeDayObjectsqueryBoolean, default: falseNoInclude received day objects in the result
ObjectFilterqueryEnum: None, Hour, Day, LastDayOnly, MonthNoGives option to filter return objects, for example to get always only hour records or day records
Generic Parameters:
NameParameterData TypeRequiredDescription
ApiKeyformStringYesApi-key. Used to provide credentials to the api. Can also be provided through the request headers with key: X-API-KEY
Filter Enum:
None
Hour
Day
LastDayOnly
Month
P4ReadingsBulk Parameters:
NameParameterData TypeRequiredDescription
MessageformstringNo
TimeStampformstringYes
DayObjectCountformint?No
IntervalObjectCountformint?No
RejectionObjectCountformint?No
DayObjectsformList<P4ReadingDay>No
IntervalObjectsformList<P4ReadingInterval>No
RejectionObjectsformList<P4Rejection>No
P4ReadingDay Parameters:
NameParameterData TypeRequiredDescription
EanformstringNo
MeterIdformstringNo
QueryDateformDateOnlyNo
MeasureUnitformstringNo
R180formdecimal?No
R181formdecimal?No
R182formdecimal?No
R280formdecimal?No
R281formdecimal?No
R282formdecimal?No
P4ReadingInterval Parameters:
NameParameterData TypeRequiredDescription
EanformstringNo
MeterIdformstringNo
QueryDateformDateOnlyNo
MeasureUnitformstringNo
ItemsformList<P4ReadingIntervalItem>No
P4ReadingIntervalItem Parameters:
NameParameterData TypeRequiredDescription
DateTimeOffsetformDateTimeOffsetNo
R180formdecimalNo
R280formdecimal?No
P4Rejection Parameters:
NameParameterData TypeRequiredDescription
EanformstringNo
QueryDateformDateOnlyNo
QueryReasonformstringNo
RejectionCodeformstringNo
RejectionTextformstringNo

To override the Content-type in your clients, use the HTTP Accept Header, append the .json suffix or ?format=json

To embed the response in a jsonp callback, append ?callback=myCallback

HTTP + JSON

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/json
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: length

{"message":"String","timeStamp":"String","dayObjectCount":0,"intervalObjectCount":0,"rejectionObjectCount":0,"dayObjects":[{"ean":"String","meterId":"String","queryDate":"0001-01-01","measureUnit":"String","r180":0,"r181":0,"r182":0,"r280":0,"r281":0,"r282":0}],"intervalObjects":[{"ean":"String","meterId":"String","queryDate":"0001-01-01","measureUnit":"String","items":[{"dateTimeOffset":"0001-01-01T00:00:00+00:00","r180":0,"r280":0}]}],"rejectionObjects":[{"ean":"String","queryDate":"0001-01-01","queryReason":"String","rejectionCode":"String","rejectionText":"String"}]}