Versions Compared
compared with
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Beskrivning
Tjänsten listar mätdata beroende på vilken kategori som anges.
Livscykelstatus
Design
Lösningsbeskrivning
<Infoga en Gliffy-bild som visuellt beskriver lösningen>
Hantering av personuppgifter
<Vilka personuppgifter hanteras och varför?>
API specifikation
Draft:
Swagger ui |
---|
---
openapi: 3.0.2
info:
title: MeasurementData API
description: "API for fetching measurement-data"
version: 1.0.0
tags:
- name: MeasurementData API endpoints
paths:
/measurmentdata:
post:
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/GetMeasurementDataRequest'
required: true
responses:
"200":
description: Successful operation
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/ElectricityData'
- $ref: '#/components/schemas/BroadbandData'
- $ref: '#/components/schemas/ElectricityData'
- $ref: '#/components/schemas/DistrictHeatingData'
- $ref: '#/components/schemas/WasteManagementData'
discriminator:
propertyName: objectType
mapping:
electricityData: '#/components/schemas/ElectricityData'
broadbandData: '#/components/schemas/BroadbandData'
districtHeatingData: '#/components/schemas/DistrictHeatingData'
wasteManagementgData: '#/components/schemas/WasteManagementData'
"400":
description: Bad request
- correct message id (UUID) must be provided
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceErrorResponse'
"500":
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ServiceErrorResponse'
components:
schemas:
GetMeasurementDataRequest:
type: object
properties:
personId:
type: string
description: Person ID
example: '81471222-5798-11e9-ae24-57fa13b361e1'
category:
type: string
description: Category
example: 'ELECTRICITY'
facilityId:
type: string
description: Facility ID
example: '112233'
fromDate:
type: string
format: date
description: From-date
example: '2022-01-01'
toDate:
type: string
format: date
description: To-date
example: '2022-03-01'
BroadbandData:
type: object
description: Electricity measurments
required:
- objectType
properties:
objectType:
type: string
example: 'electricityData'
measurements:
type: array
description: Measurement
items:
type: object
properties:
installationId:
type: string
example: '1112233'
unit:
type: string
example: 'GB'
value:
type: number
format: float
example: '22.43'
ElectricityData:
type: object
description: Electricity measurments
required:
- objectType
properties:
objectType:
type: string
example: 'electricityData'
measurements:
type: array
description: Measurement
items:
type: object
properties:
installationId:
type: string
example: '1112233'
fromDate:
type: string
format: date-time
example: '2022-01-01 00:00:00'
toDate:
type: string
format: date-time
example: '2022-01-02 23:59:00'
readingType:
type: string
example: 'Aktiv'
value:
type: number
format: float
example: '6.10000'
unit:
type: string
example: 'kWh'
degreeDay:
type: number
format: float
example: '-3.524'
WasteManagementData:
type: object
description: WasteManagement measurments
required:
- objectType
properties:
objectType:
type: string
example: 'wasteManagementData'
measurements:
type: array
description: Measurement
items:
type: object
properties:
installationId:
type: string
example: '1112233'
readingTime:
type: string
format: date-time
example: '2022-01-02 23:59:00'
value:
type: number
format: float
example: '6.10000'
productId:
type: string
example: '1063-1380-0-0-0'
location:
type: string
example: 'Blåberget'
externalId:
type: string
example: '1302069'
DistrictHeatingData:
type: object
description: DistrictHeating measurments
required:
- objectType
properties:
objectType:
type: string
example: 'districtHeatingData'
measurements:
type: array
description: Measurement
items:
type: object
properties:
installationId:
type: string
example: '1112233'
fromDate:
type: string
format: date-time
example: '2022-01-01 00:00:00'
toDate:
type: string
format: date-time
example: '2022-01-02 23:59:00'
energy:
type: number
format: float
example: '4.160000'
volume:
type: number
format: float
example: '96.10000'
qW:
type: number
format: float
example: '23.10000'
averageQw:
type: number
format: float
example: '28.10000'
effect:
type: number
format: float
example: '0.0180000'
averageEffect:
type: number
format: float
example: '0.0240003'
subscribedEffect:
type: string
example: '15'
unit:
type: string
example: 'kWh'
averegeDegreeDay:
type: number
format: float
example: '-3.524'
degreeDays:
type: number
format: float
example: '744.145'
ServiceErrorResponse:
type: object
properties:
httpCode:
format: int32
type: integer
message:
type: string
technicalDetails:
$ref: '#/components/schemas/TechnicalDetails'
TechnicalDetails:
type: object
properties:
rootCode:
format: int32
type: integer
rootCause:
type: string
serviceId:
type: string
requestId:
type: string
details:
type: array
items:
type: string
|
Säkerhetsklassning
Säkerhetsklass <0, 1, 2, 3, 4>
Autentiseringsmetod: <API Key, Oauth2>
(Ref: Säkerhetsklassning av APIer )
API-ägare
<Kontaktuppgifter till den verksamhet som äger APIets livscykel>
Teknisk ägare
<Kontaktuppgifter till utvecklare/teknisk förvaltare>
Länkar
<Länkar till dev-portal;
Test
Sandbox
Produktion>
FAQ
<FAQ>