Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Since FEWS 2017.02 all FEWS Web Services have been unified into one installation package (FewsWebServices.war). The following WebServices are available with this installation using HTTP(s):

  • PI -XML REST Web Service: The PI -XML REST Service can be accessed using the REST protocol.
  • PI -XML SOAP Web Service: The PI -XML SOAP Service can be accessed by the SOAP protocol.
  • WaterML Web Service: The WaterML2 Web Service can be accessed by the WaterML protocol.
  • Digitale Delta Web Service: The Digitale Delta Web Service can be accessed by the REST protocol.
  • Umaquo Web Service: The Umaquo Web Service can be accessed by the SOAP protocol.

...

Before 2017.02 the FEWS PI Services always returned its response in the PI 1.9 version format. Since 2017.02 if no version is specified, the latest pi version format will be used. If it is required to get a specific version of the pi format, the version can be specified in the service call.

URL changes

PI

...

SOAP Web Service

The change that has the largest impact on the URLs of the Web services is the changed context path (the URL part after the servername + port). Before 2017.02 every FEWS Web service has its own context path. Since 2017.02 all webservices have the same context path, which is FewsWebServices by default.

For example before 2017.02 the URL endpoint of the FEWS PI -XML SOAP Web Service would be: http://localhost:8080/FewsPiServices/fewspiservice

...

If it is required to keep the endpoints backwards compatible, the FewsWebServices.war can be renamed into FewsPiServices.war.

PI

...

REST Web Service

For the PI -XML REST Web Service it is not possible to keep the endpoints backwards compatible since the "rest" path is now a required part of the endpoint.

...