Skip to main content

Dashboard stream API

This API is based on the Device Configuration API framework. For guidance on how to use these APIs, please refer to the Device Configuration APIs section in the VAPIX Library.

warning

This API is in BETA stage. The API is provided for testing purposes and is subject to backward-incompatible changes, including modifications to functionality, behavior, and availability. Please don't use in production environment.

Overview​

The Dashboard stream API provides configuration of air quality dashboard stream.

Use the API to configure:

  • Dark mode
  • Display language

Use cases​

Get root entity​

This example shows how to get the root entity.

GET /config/rest/dashboard-stream/v1beta HTTP/1.1
HOST: my-device
HTTP/1.1 200 OK
Content-Type: application/json

{
    "status": "success",
    "data": {
        "darkmode": true,
        "language": "en"
    }
}

API definition​

Structure​

dashboard-stream.v1beta (Root Entity)
    ├── darkmode (Property)
    ├── language (Property)

Entities​

dashboard-stream.v1beta​

  • Description: Configuration root object
  • Type: Singleton
  • Operations
    • GET
  • Attributes
    • Dynamic Support: No
Properties​
darkmode​
  • Description: Enable or disable dark mode
  • Data type: boolean
  • Operations
    • GET (Permissions: admin, operator, viewer)
    • SET (Permissions: admin)
  • Attributes
    • Nullable: No
    • Dynamic Support: No / Dynamic Enum: No / Dynamic Range: No
language​
  • Description: Language display in dashboard stream
  • Data type: Language
  • Operations
    • GET (Permissions: admin, operator, viewer)
    • SET (Permissions: admin)
  • Attributes
    • Nullable: No
    • Dynamic Support: No / Dynamic Enum: No / Dynamic Range: No
Actions​

This entity has no actions.

Data types​

Language​

  • Description: The display language of the dashboard stream
  • Type: string
  • Enum Values: "cs", "de", "en", "es", "fr", "it", "nl", "pl", "pt", "fi", "sv", "vi", "tr", "ru", "th", "ko", "zh", "zh-TW", "ja"