...
- SSD (required): the name of the SSD "DisplayPanel" to query. Only one SSD can be queried at a time.
- OBJECTID: the id of the SVG object to retrieve the configured actions for.
- ACTION: the type of user interaction, can be either LEFTSINGLECLICK or LEFTDOUBLECLICK (case insensitive)
- TIMEZERO : the reference time0 which is used to transform relative times used in the SSD or timeseries display configuration to absolute date/time values (default is current time)
- FORMAT (optional) : the requested output format. ( 'application/xml' or 'application/json') The default format is XML.
- OPTIONS (optional) : one or more specific options that affect the output, separated by commas. Currently supported are CONFIG (providing additional configuration information) and IMPORTFROMEXTERNALDATASOURCE (add support for external data from a configured FEWS Open Archive)
(for example: OPTIONS=CONFIG,IMPORTFROMEXTERNALDATASOURCE to provide both)
note: it is also possible to specify these optons separately using the syntax CONFIG=TRUE or IMPORTFROMEXTERNALDATASOURCE=TRUE
Response
The response to the GetAction request is XML or JSON formatted text giving information about the action that has been configured in FEWS. An action always consists of an action (or service) type (i.e. open another SSD panel, url of PDF document). For example a configured "switchToScadaPanel" action response in XML format:
...
Code Block |
---|
{
"results" : [ {
"type" : "PI",
"requests" : [ {
"request" : "rest/fewspiservice/v1/timeseries?timeSeriesType=EXTERNAL_HISTORICAL&locationIds=IJS_ReestWieden_In¶meterIds=Q.balans.in&moduleInstanceIds=Import_dump&startTime=2019-10-25T12%3A50%3A00Z&endTime=2019-11-02T12%3A50%3A00Z"
}, {
"request" : "rest/fewspiservice/v1/timeseries?timeSeriesType=EXTERNAL_HISTORICAL&locationIds=IJS_ReestWieden_In¶meterIds=Q.balans.in&moduleInstanceIds=Import_dump&qualifierIds=Gemiddelde&qualifierIds=24uur&timeStepId=Hydro_dag&startTime=2019-10-25T12%3A50%3A00Z&endTime=2019-11-02T12%3A50%3A00Z"
}, {
"request" : "rest/fewspiservice/v1/timeseries?timeSeriesType=EXTERNAL_FORECASTING&locationIds=IJS_ReestWieden_In¶meterIds=Q.balans.in&moduleInstanceIds=Import_dump&qualifierIds=Gemiddelde&qualifierIds=Nu&startTime=2019-11-01T11%3A50%3A00Z&endTime=2019-11-01T12%3A50%3A00Z"
} ]
} ]
} |
GetVersion (2022.01)
GET version inforamtion of the current installed Web Services.
Request parameters
- documentFormat (string): PI_XML (default) or PI_JSON
Response
- PI-XML or PI-JSON file content.
Example request
Code Block |
---|
curl "http://localhost:8080/FewsWebServices/ssd?request=GetVersion"
|
Example PI-XML response
Code Block |
---|
<?xml version="1.0" encoding="UTF-8"?>
<Version xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.wldelft.nl/fews/PI" xsi:schemaLocation="http://www.wldelft.nl/fews/PI http://fews.wldelft.nl/schemas/version1.0/pi-schemas/pi_version.xsd">
<implementation>2017.02</implementation>
<buildType>stable</buildType>
<buildNumber>12345</buildNumber>
<buildTime>2017-10-31T23:00:00Z</buildTime>
</Version> |
GetOAS (2022.01)
GET open api specification of the SSDService.
Response
- JSON response with the open api specification.
Example request
Code Block |
---|
curl "http://localhost:8080/FewsWebServices/ssd?request=GetOAS"
|
Example PI-XML response
Code Block |
---|
{
"openapi" : "3.0.3",
"info" : {
"title" : "Delft-FEWS Web Services - WMS Service",
"description" : "Delft-FEWS Web Services - SSD Service",
"version" : ""
},
"servers" : [ {
"url" : "/FewsWebServices",
"description" : "API server"
} ]
} |
Implementation status
...