Sign in
Data Collection

Push data collection values

Push values to data collection items with origin "push". Multiple values for different objects and DCIs can be submitted in a single request.

Target object is identified either by objectId or by objectName, and target DCI either by dciId or by dciName. When a DCI is addressed by name and does not exist yet, the server attempts to create it through instance discovery.

The whole batch is validated before any value is pushed, so a request either applies completely or has no effect at all. If validation fails, the response body identifies the offending element by its position in the request array.

Requires OBJECT_ACCESS_PUSH_DATA on every target object.

post/v1/push-data

Request body

objectIdinteger

Target object ID

objectNamestring

Target object name, used when objectId is not provided. Matched case-insensitively against data collection targets only.

dciIdinteger

Target DCI ID

dciNamestring

Target DCI name, used when dciId is not provided. If no matching DCI exists, the server attempts to create one through instance discovery.

Response

Values pushed successfully

Changes

Changed in 1 of the 80 revisions of this API.1