Scailable Dataviewer (1.1.0)

Download OpenAPI specification:Download

The Scailable Data API is responsible for returning cloud data.

What can you do with this API

The Data API exposes destinations for each device, model and input source. These destinations contain the collected data from the models running on an edge device.

With the calls in this API you can browse the collected data that your devices and models generated.

And for live viewing data can be peeked in realtime.

Quick start

Get a list of available destinations by sending a GET request to /destinations.

Download the data for a destination by sending a POST request to /destination/download with the selected Device, Model and Input IDs as query parameters.

Use a GET request to /peek/{device}/{model}/{source} to get the newest available datapoint for a given destination.

Technical environment

The Scailable Data API is part of the Scailable Cloud and handles the reading of data from the collected output of the models.


Download

Request download

Request download.

Time-out set to 5s. Requires an authenticated user.

Authorizations:
User
Request Body schema: application/json
ContentType
required
string
Device
string <uuid>

Identifier

DeviceSerial
string
Function
string <uuid>

Identifier

ModelID
string
SecuredClient
boolean
SourceID
required
string

Responses

Request samples

Content type
application/json
{
  • "ContentType": "string",
  • "Device": "3edd0e15-e892-4b42-8508-d351e5348df3",
  • "DeviceSerial": "string",
  • "Function": "8e7b8e71-c3d8-492a-b716-c62c2634a634",
  • "ModelID": "string",
  • "SecuredClient": true,
  • "SourceID": "string"
}

Response samples

Content type
application/json
{
  • "ContentType": "string",
  • "ExpiresAt": "2019-08-24T14:15:22Z",
  • "Location": "string"
}

Request download

Request download.

Time-out set to 5s. Requires an authenticated user.

Authorizations:
User
Request Body schema: application/json
Device
string <uuid>

Identifier

DeviceSerial
string
Function
string <uuid>

Identifier

ModelID
string
SecuredClient
boolean
SourceID
required
string
Target
required
string

Responses

Request samples

Content type
application/json
{
  • "Device": "3edd0e15-e892-4b42-8508-d351e5348df3",
  • "DeviceSerial": "string",
  • "Function": "8e7b8e71-c3d8-492a-b716-c62c2634a634",
  • "ModelID": "string",
  • "SecuredClient": true,
  • "SourceID": "string",
  • "Target": "string"
}

Response samples

Content type
application/json
{
  • "ContentType": "string",
  • "ExpiresAt": "2019-08-24T14:15:22Z",
  • "Location": "string"
}

Download data points by request

Download data points by request.

Time-out set to 4h0m0s.

path Parameters
uuid
required
any

Use download-by-request uuid

filename
required
any

Use filename

Responses

Response samples

Content type
application/json
{
  • "Message": "string"
}

Destination

List destinations within the users' organisation

List destinations within the users' organisation.

Time-out set to 5s. Requires an authenticated user.

Authorizations:
User
query Parameters
Offset
integer

Number of items to skip from beginning of list (base 0)

Limit
integer

Number of items to return

OrderBy
string

Order the list by these fields. Add a '-' in front of the field to reverse sort and to sort on multiple fields separate them by a comma.

Device
string <uuid>

filter by device

Responses

Response samples

Content type
application/json
[
  • {
    }
]

OpenAPI

Return the OpenAPI documentation

Return the OpenAPI documentation.

Responses

Response samples

Content type
application/json
{
  • "Message": "string"
}

View

Peek last data point

Return the last data point we received. Return type depends on data type.

Time-out set to 1s. Requires an authenticated user.

Authorizations:
User
path Parameters
device
required
any

Use device

model
required
any

Use model

source
required
any

Use source

Responses

Response samples

Content type
application/json
{
  • "Message": "string"
}

Query data points

Query data points.

Time-out set to 5s. Requires an authenticated user.

Authorizations:
User
path Parameters
device
required
any

Use device

model
required
any

Use model

source
required
any

Use source

query Parameters
From
any

filter by from

To
any

filter by to

BoundingBoxSize
any

filter by boundingboxsize

CentroidSize
any

filter by centroidsize

Aggregate
any

filter by aggregate

Responses

Response samples

Content type
application/json
{
  • "Message": "string"
}

Cloud

Return the online status of the service

Return the online status of the service.

Responses

Response samples

Content type
application/json
{
  • "Online": true
}