Page History

...

Get all displaygroups nodes: https://fewsdocs.deltares.nl/webservices/rest-api/v1/#get-/displaygroups/nodes

GET lastrefreshtime(2023.02)

GET the last refresh time of the Web Service. Can be used to make sure indexes have been updated before making any requests. Typical example may be to retrieve a new forecast for which you are sure it is already available in the Delft-FEWS database. Before retrieving the new forecast keep requesting the last refresh time until you see a change in the last refresh time. This will make sure the indexes have been updated and the new forecast can be found with the WebServices. For this endpoint to work reliable in a setup with multiple web services and a load balancer, it is required that the client that connects to this endpoint is always directed to the same Web Service instance.

Request parameters

• documentFormat (string): TEXT (default) or PI_JSON

Response

• • text response with the actual system time.  Format: yyyy-MM-ddTHH:mm:ssZ

Example request

curl "http://localhost:8080/FewsWebServices/rest/fewspiservice/v1/lastrefreshtime"

Example text response

2020-03-18T15:00:00Z

FEWS PI REST Web Service API - Embedded endpoints

...

GET the system time as configured in the Operator Client of Stand Alone

Request parameters

• documentFormat (string): TEXT (default) or PI_JSON

Response

• • text response with the actual system time.  Format: yyyy-MM-ddTHH:mm:ssZ

Example request

curl "http://localhost:8080/FewsWebServices/rest/fewspiservice/v1/systemtime"

Example text response

2020-03-18T15:00:00Z

...

Get the last time the timeseries were updated in the Operator Client or a Stand Alone. It returns the last time the main time series dialog loaded time series. Time series dialog will only reload the time series when displayed time series are changed in the database or the user selected something different. The method was implemented for a very specific use case and is not recommended to be used anymore.

Request parameters

• documentFormat (string): TEXT (default) or PI_JSON

Response

• • text response with the last update time.  Format: yyyy-MM-ddTHH:mm:ssZ

Example request

curl "http://localhost:8080/FewsWebServices/rest/fewspiservice/v1/lastupdatetime"

Example text response

2020-03-18T15:00:00Z

...

Get the currently selected topology node id in the Operator Client or a Stand Alone

Request parameters

• documentFormat (string): PI_JSON

Response

• • PI_JSON response

Example request

curl "http://localhost:8080/FewsWebServices/rest/fewspiservice/v1/topology/selected"

Example text response

{
"topologyNodeId": "string"
}

...

Get the currently selected parameter ids in the Operator Client or a Stand Alone

Request parameters

• documentFormat (string): PI_JSON

Response

• • PI_JSON response

Example request

curl "http://localhost:8080/FewsWebServices/rest/fewspiservice/v1/parameters/selected"

Example text response

{
  "parameterIds": [
    "string"
  ]
}

...

GET the system time as configured in the Operator Client of Stand Alone

Request parameters

• documentFormat (string):  PI_JSON

Response

• • PI_JSON response

Example request

curl "http://localhost:8080/FewsWebServices/rest/fewspiservice/v1/filters/selected"

Example text response

{
  "filterIds": [
    "string"
  ]
}

...

Get the currently selected location ids in the Operator Client or a Stand Alone

Request parameters

• documentFormat (string):  PI_JSON

Response

• • PI_JSON

Example request

curl "http://localhost:8080/FewsWebServices/rest/fewspiservice/v1/locations/selected"

Example text response

{
  "locationIds": [
    "string"
  ]
}

...

Get the time series for the selected topology node

Request parameters

• documentFormat (string): PI_XML (default) or PI_JSON
• topologyNodeId (string): Id of the topology node for which the time series will be returned.
• timeZero (date): time zero in format: yyyy-MM-ddTHH:mm:ssZ
• startTime (date): Optional startTime for the requested period in format: yyyy-MM-ddTHH:mm:ssZ. If not set, the start time of the zoom period in the first time series dialog will be used.
• endTime (date): Optional endTime for the requested period in format: yyyy-MM-ddTHH:mm:ssZ. If not set, the end time of the zoom period in the first time series dialog will be used.
• thresholdsVisible (boolean): Set to true to make thresholds visible.
• omitMissing (boolean): Toggle omitting or returning of missing values in response. Default is true
• useDisplayUnits (boolean): Set to true to use display units
• convertDatum (boolean): Set to true to convert datum
• documentVersion (string): Document Version

Response

• • Timeseries in PI_XML or PI_JSON format

Example request

curl "http://localhost:8080/FewsWebServices/rest/fewspiservice/v1/timeseries/topology/node"

Example text response

FEWS PI REST Web Service API - Web Operator Client endpoints

...

GET the web OC Configuration

Response

• • JSON response with the Web OC configuration.

Example request

curl "http://localhost:8080/FewsWebServices/rest/fewspiservice/v1/weboc/configuration"

Example text response

{
  "components": [
    {
      "type": "string",
      "title": "string"
    }
  ],
  "general": {
    "title": "string",
    "icons": {
      "logo": "string",
      "favicon": "string"
    }
  }
}

...