Insert multiple Tag values

Add the specified tag values with their timestamps.

Example URL

https://api.icube.co.th/integration/webapi/tag/value?mode=write

Last Update: 1 NOV 2024

Add Tag Values

Method: POST

URL: {{base_url}}/tag/value?mode=write


Query Parameters:

ParameterData TypeDescription

mode

string

Mode of the Request

  • read: Use this mode to retrieve data.

  • write: Use this mode to insert data.

(Default: mode=read)

updateStatus

bool

Update Status of data

  • True: Use this when need to update the status of data

  • False: Use this when don't need to update the status of data

(Default: updateStatus=False)

clearAll

bool

Clear records of data

  • True: Use this when need to clear all records of data before insert the new one

  • False: Use this when don't need to clear all records of data before insert the new one

(Default: clearAll=False)


Request Body:

The request body must be an array of tag value objects, each containing the following parameters:

ParameterData TypeDescription

TagName

string

Name of the tag to which the value belongs.

timeStamp

datetime

Timestamp of the value being written.

value

variant

Value associated with the tag. It can be one of the following data types:

Value Data Types:

Data TypeDescription

string

Represents text data.

int

Represents integer data.

double

Represents floating-point data.

bool

Represents boolean values (true/false).


Example Request Body:

[
    {
        "TagName": "string",
        "timeStamp": "datetime",
        "value": "variant"
    },
    {
        "TagName": "string",
        "timeStamp": "datetime",
        "value": "variant"
    }
]

Response Example:

{
    "message": "string"
}

Response Details:

ObjectData TypeDescription

message

string

Success message indicating the result of the write operation.

Last updated