/reporting/Dp

"/reporting/Dp"
The endpoint "/reporting/Dp" queries the online value or historical values of a data point.
The "/reporting/Dp" endpoint provides for every data point:
  • the value,
  • the timestamp when the value was written to the data point,
  • the status bits.
  • the manager who has written the value
Note: We recommend using the /reporting/Dps endpoint instead. It is available as of the REST Reporting API Version 2.0 (WinCC OA 3.19-P002).

The "/reporting/Dp" endpoint requires one parameter and has two optional parameters.

Parameter Description

The first required parameter is the data point name including the system name.
from

The two optional parameters are a timestamp for from and a timestamp for to.

The format of the timestamp is ISO format.

When only the from parameter is given, the API will set the to parameter to the current date and time.

If the parameters from and to are not specified, the online value is queried.
to
Note: There is a count parameter but it is not configurable and is always 1.

Example without date

Request:

https://HOST:443/reporting/Dp?System1:ExampleDP_Rpt1

Response:

[
   10.599999999999998,"2021-01-26T13:04:32.369Z",
   "1000001100000000000000000000000000000000001100000000000100000001",
   "UI -num 1"
]

Example with date

Request:

https://HOST:443/reporting/Dp?System1:ExampleDP_Rpt1&from=2021-01-01T12:47:37.369Z

Response:

[ [
     10.999999999999996,
     "2021-01-22T16:42:14.881Z",
     "1000001100000000000000000000000000000000001100000000000100000001",
     "UI -num 1"
   ],
   [
      11.199999999999996,
      "2021-01-22T16:42:15.880Z",
      "1000001100000000000000000000000000000000001100000000000100000001",
      "UI -num 1"
   ]]