From the previous example: API: Explore assets using hierarchies, you now collected some assets unique identifier and you want to know more this asset.

As learnt in Linksper assets, an asset can be a piece of a Model, an Equipment, a Device...

These is what you can do from a model:


Get more information about an asset

You collected an asset from a previous query and now you want to learn more about it. You can use this query:

{{base-api-url}}/v1/explore/assets/:id


To even get more information, we will add two additional parameters:

  • allTags
  • allRelations
{{base-api-url}}/v1/explore/assets/:id?additionalFields=allTags&additionalFields=allRelations


Let's see what it looks like:


  • You can see much more tags. They are coming from the various data models implemented by this equipment
  • You can see at the bottom two interesting fields showing relations with other assets. You can use the same query to explore these assets.



Explore related equipment to an asset

This is restricted to only certain kinds of assets: Model, LinksperInstance, Device and Equipment (for subEquipment only).

We can use it for example to learn all equipment located in a specific space. From a query based on hierarchies, we learnt in VayanData headquarters, there is a Space called "Kitchen" with the following Id "0aDGw8OsvFhxkkdoZZmxra"

{{base-api-url}}/v1/explore/assets/:id/equipment?additionalFields=b:equipmentType


We can get the list of equipment from the Kitchen.


Explore related devices to an asset

This is restricted to only certain kinds of assets: Model, LinksperInstance, Equipment

We can use it for example to learn all devices located in a specific space. From a query based on hierarchies, we learnt in VayanData headquarters, there is a Space called "Kitchen" with the following Id "0aDGw8OsvFhxkkdoZZmxra"

{{base-api-url}}/v1/explore/assets/:id?additionalFields=allTags&additionalFields=allRelations


We can get the list of devices from the Kitchen.



Explore related points of an asset

This is restricted to only certain kinds of assets: Model, LinksperInstance, Equipment and Device

You can get all the Data points of a space, of a precise equipment, a precise Device...

Let's ask the API for data points of the Room Operating Unit of the Kitchen we collected above:

{{base-api-url}}/v1/explore/assets/:id/points


Let's take another example with all the data points related to an asset of a data model (you can explore the different data model assets here: Linksper data models). Let's take the example of "Concentration" which is widely used for air quality related data points. The "Concentration" asset has this unique id: "P0SDQgHDBp5NTmhhTOmRr" shared across all Linksper instances. If we use the same query, we will get all Concentration related data points: