We are currently on V3 of the FME Server REST API and, even though the documentation claims "FME Server REST API V3 is our stable REST API", this is not actually the case. A quick look at the REST API documentation for an FME Server 2017 installation, compared to an FME Server 2019 installation will reveal significant differences.
It would be great to have a query that could be run against the API to return the true version (I REALLY hope that Safe is tracking changes to the API as difference versions...). At least if the version was available, then users of the API could program their solutions to take account of the differences if possible.
It would also be great if the documentation could indicate in which version of the API a certain functionality added or updated/modified.
As an example, FME Server 2017 offers the following endpoint:
GET /transformations/jobs/< section >
where <section> can refer to Completed/Running/Queued
In response to a query to this endpoint, the "request" item contains a "workspacePath" value which can be used to extract the repository and workspace details but there is no direct response item for these values.
FME Server 2019 offers documentation on direct endpoints, such as:
GET /transformations/jobs/completed
A response to the above query contains additional information in the "job" portion of the response, which provides access to the repository and workspace names (not available in 2017).
In summary, an application written to work against "V3" of the REST API is not guaranteed to work if the underlying FME Server version changes.
Please update the REST API to make it simple to programatically query the true version of the API being used or, even better, to programatically query the API itself to determine its capabilities and query/response schemas.
