Supported versions

AVEVA Insight supports version 2 of the Historian Data REST API. This is the current and recommended version of the Historian Data REST API.

Version 2 of this REST API is based on version 1 and includes further enhancements. Version 2 includes these differences from version 1:

• The TagFilter parameter is supported as part of a GET or POST query used with ProcessValues, AnalogSummary, and StateSummary resources.

• The DateTimeOffset parameter is not supported as part of the DateTime syntax.

• While Raw and ProcessValues entities use DateTime, Summary entities use StartDateTime and EndDateTime.

• For most version 2 queries, single quotes are not used for DateTime. For example:

  https://online.wonderware.[DOMAINSUFFIX]/apis/Historian/v2/ProcessValues?$filter=DateTime+gt+2017-07-13T00:00:00

  However, when querying events, single quotes are required for DateTime. For example:

  https://online.wonderware.[DOMAINSUFFIX]/apis/Historian/v2/Events?$filter=EventTime+gt+'2017-07-13T00:00:00'

  By contrast, version 1 queries do use single quotes for DateTime. For example:

  https://online.wonderware.[DOMAINSUFFIX]/apis/Historian/v1/ProcessValues?$filter=DateTime+gt+datetimeoffset'2017-07-13T00:00:00'

• TagProperty and Events entity types are now open type. That is, dynamic properties can be added to the response at runtime. This can be verified using $metadata endpoint URL:

  https://online.wonderware.[DOMAINSUFFIX]/s/<solution_id>/apis/historian/v2/$metadata

  where there will be additional attribute, OpenType="true", under <EntityType> section.

• The Tags resource returns all the properties (fixed and extended) for a tag. A tag's extended properties will be added to the response only if they exist. (The extended property name will not be listed for tags that do not have a given extended property.)

• The combined Summary resource is not supported in version 2. Use the individual AnalogSummary and StateSummary resources instead to retrieve a tag's summarized data.

• AVEVA Insight returns a list of resources and endpoints in JSON format instead of the previously used XML when you specify the default endpoint URL for your solution (where <solution_id> is the identifier for your AVEVA Insight solution):

  https://online.wonderware.[DOMAINSUFFIX]/s/<solution_id>/apis/historian/v2

• Version 2 adds support for the OData contains function for applicable resources and properties.