Skenarios service has an API which can be used to maintain portfolio and properties. The base URL for all requests is https://api.skenarios.com/
...
Response | Explanation |
---|---|
200 OK | Your request was processed successfully |
201 Created | Your request was processed successfully, an object was created |
400 Bad Request | Something is wrong in the received data or query. This is most likely a format issue. |
401 Unauthorized | Your request was not authorized, please check the JWT token. |
403 Forbidden | The user-specified in the JWT token has no access privileges on the given object. |
404 Not Found | The requested service doesn't exist |
422 Unprocessable Entity | Sent parameters were understood, but their content was problematic. Please check your input. |
500 Internal Server Error | Whoops! This is embarrassing, something unexpected happened. We'll take a look at the issue as soon as possible. |
...
Name | Type | Is mandatory? | Description |
---|---|---|---|
buildingId | String | Yes | Unique Building id, given by the organizationorganisation |
name | String | Yes | Building name |
buildYear | Integer | Build year of the property building | |
description | String | Free text description of the property | |
country | StringYes | Country code of the property building, allowed values are FI and UK. | |
buildingType | String | Type of the main property: row house, office, commercial building, detached house, leisure house, apartment, school, retail building, industrial building, garage, warehouse, generic building | |
facadeMaterial | String | The primary building material of the walls of the building. Allowed values are empty, brick, wood, concrete | |
heatingEnergyType | String | primary heating source, allowed values are: ground, electric, district, wood, oil, gas, other. | |
balconies | Integer | Number of balconies in the property | |
units | Integer | Total number of property units in the property | |
lifts | Integer | Total number of lifts in the property | |
floors | Integer/Double | The total number of floors in the property, the ground floor being 1. If a double value is sent, it will be rounded up to the nearest integer e.g. 1.5 will be rounded to 2 | |
balconies | Integer | Total number of balconies in the property | |
floorArea | Integer/Double | Total gross floor area of the property, including cold and heated spaces in m2. If a double value is sent, it will be rounded up to the nearest integer e.g. 99.80 will be rounded to 100 | |
volume | Integer | Total gross volume of the property, including cold and heated spaces in m3. | |
address | StringYes | Street address of a building. This is mandatory unless building id matches with known national property ids. | |
postalCode | StringYes | Postcode of a building. | |
city | StringYes | City where a building is located. | |
useExistingIfAvailable | boolean | If true, tries to find an existing property with building and address details. If found uses that and updates with given other details. Otherwise, creates a new one and returns it. | |
properties | array | An array of specific properties related to this building. The exact keys depend on the organization, however, common keys for everybody are presented in table below. For example: [{"propertyId":"LOT_OWNED", "value" :"yes"},{"propertyId":"LOT_SIZE", "value" :1400}] | |
measures | array | An array of specific values related to this property. Keys are presented in the table below. For example: [{"type":"MONTHLY_LOT_LEASE_AMOUNT", "value" :350}] |
...