iCube
  • iCube Learning
  • Introduction
    • What is iCube?
  • iCube Platform
    • iCube Server
      • Overview
      • Data
        • Value & Value Relation editor
          • Query Data
          • Add Data
          • Update Data
          • Delete Data
      • Tag
        • What is Tag?
          • Tag configuration
            • Create Tag
            • Update Tag
            • Delete Tag
        • What is TagRelation?
          • TagRelation configuration
            • Create TagRelation
            • Update TagRelation
            • Delete TagRelation
      • Interface
        • Interface configuration
          • Create Interface
          • Update Interface
          • Delete Interface
        • Mapping configuration
          • Create Mapping
          • Update Mapping
          • Delete Mapping
      • Integration
        • Provider
          • [Integration Provider] API Document
            • Get service list all
            • Get connection
            • Get Tag all
            • Get Tag Relation all
            • Get Tag by name
            • Get Tag Relation by name
            • Get single Tag value
            • Get single Tag Relation value
            • Get multiple Tag values
            • Get multiple Tag Relation values
            • Get multiple Tag values (with Body)
            • Get multiple Tag Relation values (with Body)
            • Insert multiple Tag values
            • Insert multiple Tag Relation values
            • Update multiple Tag value
            • Update multiple Tag Relation value
            • Delete multiple Tag values
            • Delete multiple Tag Relation values
          • APIs Document
            • Get service lists
            • Get connection
            • Get tags
            • Get tagrelations
            • Get tag by tagname
            • Get tagrelation by tagrelation name
            • Get single tag value
            • Get single tagrelation value
            • Get multiple tags values
            • Get multiple tagrelations values
            • Get multiple tags values (with Body)
            • Get multiple tagrelations values (with Body)
            • Insert multiple tag values
            • Insert multiple tagrelation values
            • Update multiple tag values
            • Update multiple tagrelation values
        • Publisher
          • Create Publisher
          • Update Publisher
          • Delete Publisher
      • Scheduling
        • Create Schedule
        • Update Schedule
        • Delete Schedule
      • Security
        • User configuration
          • Create User
          • Update User
          • Delete User
        • Role & Permission configuration
          • Create Role
          • Update Role
          • Delete Role
        • Token provider configuration
          • Create Token
          • Delete Token
    • iCube Form
      • Overview
        • Create Group
        • Manage Group
        • Setting Group
        • Delete Group
      • Form
        • Create Form
        • Setting Form
        • Design
          • Input
          • Editor
          • Card
          • Date Form
          • Table
          • Submit Button
          • Navigate
          • Signature
          • Drop Down
          • Upload file
          • Custom graphic
        • Duplicate Form
        • Delete Form
      • Workflow
        • Task
        • Request
          • Action
          • Create Request
        • Flow Template
          • Create Flow Template
          • Update Flow Template
          • Delete Flow Template
        • Workflow history
      • History
        • Form
      • Upload
      • Security
        • User
        • Role Permission
        • Menu Permission
    • Power BI Connector
      • Download & Install
      • Setting Options Security
  • iCube API
    • Overview of Resource URL Patterns
      • Get Connection
      • Get Tag all
      • Get Tag Relation all
      • Get Tag detail
      • Get Tag Relation detail
      • Get single Tag value
      • Get single Tag Relation value
      • Get multiple Tag values
      • Get multiple Tag Relation values
      • Get multiple Tag values (with Body)
      • Get multiple Tag Relation values (with Body)
      • Insert multiple Tag values
      • Insert multiple Tag Relation values
      • Update single/multiple Tag value
      • Update single/multiple Tag Relation value
      • Delete multiple Tag values
      • Delete multiple Tag Relation values
Powered by GitBook
On this page
Export as PDF
  1. iCube Platform
  2. iCube Server
  3. Integration
  4. Provider
  5. [Integration Provider] API Document

Get single Tag value

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

Example URL

https://api.icube.co.th/integration/webapi/tag/B15-Status/value?starttime=*-10d&endtime=*&query=value > 50

Last Update: 1 NOV 2024

Retrieve Tag Value with Conditions

Method: GET

URL: {{base_url}}/tag/{tagname}/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., *-10y means go back 10 years)

+

Go forward (e.g., *+10mo means go forward 10 months)


Response Example:

{
    "data": [
        {
            "tagname": "string",
            "description": "string or null",
            "subDescription": "string or null",
            "value": "string",
            "quality": integer,
            "status": integer,
            "timeStamp": "datetime"
        }
    ]
}

Response Details:

Object
Data Type
Description

data

array

Array of tag value objects returned from the API.

tagname

string

Name of the tag.

description

string/null

Description of the tag, if available.

subDescription

string/null

Sub-description of the tag, if available.

value

string

Current value of the tag.

quality

integer

Quality indicator of the tag value.

status

integer

Status code associated with the tag value.

timeStamp

datetime

Timestamp when the tag value was recorded.

PreviousGet Tag Relation by nameNextGet single Tag Relation value

Last updated 6 months ago