Get the latest data from multiple Endpoints

This service allows querying the latest recorded data from up to 5 devices at the same time, using a single call.

Its use is primarily recommended when you need to display real-time information from multiple sensors simultaneously, avoiding a specific call for each one, resulting in time savings and reduced network traffic.

To use this function, make a call to the API through a specific address using the GET method.

GET /api/v2/endpointData/multiple

For security purposes, an access key identifying the requesting user is required. This key is the Access Token and must be included as part of the address.

GET https://gear-dev.cloud.studio/api/v2/endpointData/multiple?accessToken=123456789-1110-0022-3333-987654321012&endpointIds=351031,151040,252340,511088,720510

If the access key is missing or invalid, the API returns a 500 error with code 8001 in the FaultCode field. See the Errors section for the response format.

The required parameters are:

• Access Key (Access Token): Key identifying an authorized user.
• It is a String type and is mandatory.
• EndpointsIDs: IDs of the device sensors separated by commas, for which data should be retrieved.
• It is a List type and is mandatory.
• NOTE: The limit of endpoints per call is 5 (five).

If more than 5 endpointIds are sent in the request, the API returns a 500 error with code 100004 in the FaultCode field, meaning the endpoint limit has been exceeded. See the Errors section.

Once the request is correctly made, a list of objects (JSON) is received. Each object in the list will represent the information of one of the requested sensors.

The information in the list is as follows:

• EndpointID: Identification number of the queried sensor
• Description: Name of the queried sensor
• SequenceNumber: Sequential number indicating the order in which data was recorded (useful for tracking/history)
• TimeStamp_UTC: Exact date and time of the lastValue recording
• Value: Last value reported by the sensor

If an endpoint has no data, the Value and timeStamp fields will be null.

Note: The addition of this functionality affects all endpoint data query methods, as they now include the description field.

The Camera endpoint is excluded.