Get single Tag Relation value

Fetches the values of a specific tag relation identified by its name, along with optional filters for time range and conditions.

Example URL

https://api.icube.co.th/integration/webapi/tagrelation/bronze_relation_raw/value?starttime=*-10d&endtime=*&query=name like 'K%'

Last Update: 5 NOV 2024

Retrieve Tag Relation Value with Conditions

Method: GET

URL: {{base_url}}/tagrelation/{tagrelationname}/value?starttime={starttime}&endtime={endtime}&query={query}

---

Query Parameters:

Parameter	Required	Description
starttime	Yes	Starting time for filtering the data (e.g., *-10y) (Default: starttime=*-10m)
endtime	Yes	Ending time for filtering the data (e.g., *) (Default: endtime=*)
query	No	A condition to filter the results, acting like a WHERE clause in PostgreSQL.

Time Expression:

Expression	Description
sec	Second
m	Minute
h	Hour
d	Day
mo	Month
y	Year
*	Present
-	Go back (e.g., *-10d means go back 10 days)
+	Go forward (e.g., *+10mo means go forward 10 months)

---

Response Example:

{
    "data": [
        {
            "Id": "string",
            "name": "string",
            "tel": "string",
            "quality": integer,
            "status": integer,
            "timeStamp": "datetime"
        }
    ]
}

Note: The fields Id, name, and tel are placeholders and will vary depending on the specific tag relation being represented in the request. Ensure you refer to the specific tag relation schema for exact field details.

Response Details:

Object	Data Type	Description
data	array	Array of tag relation value objects returned from the API.
Id	string	Unique identifier for the tag relation.
name	string	Name associated with the tag relation.
tel	string	Telephone number associated with the tag relation.
quality	integer	Quality indicator of the tag relation value.
status	integer	Status code associated with the tag relation value.
timeStamp	datetime	Timestamp when the tag relation value was recorded.