Stable interfaces / APIs
Each FACT-Finder version maintains its APIs in way that keeps them stable for the previous three major release versions. This makes updating FACT-Finder very easy. You don’t have to change your code as long as the used API version is still supported. However, if you would like to use features of a more recent version, you might need to update your integration.
JSON / XML
For the JSON and XML interfaces this feature is available starting from FACT-Finder 7.1. The URL parameter version determines in which API version the request should be answered. Additionally, a standard return version is configured within the application so that the version parameter is not mandatory. Usually it is best to set it, but an explicit delivery of the parameter can be useful for test and migration purposes.
If for example you use the parameter for the search return and would like to keep it for API version 7.2, the request would look as follows:
$stringEscapeUtils.escapeHtml($body)FACT-Finder Version 7.3 supports versions 7.2, 7.1, 7.0 and 6.11. If no valid value is delivered, the answer will be returned in the configured standard return version (7.2 for new projects).
Webservice / SOAP
End of Life
Please note: the SOAP interface will no longer be updated or upgraded. We recommend the REST-API for new customers. If you have been using the SOAP interface so far, you can go on using it. We do however recommend changing your integration interface to improve performance.
This behaviour is already available for some time with the SOAP interface. The path to the web service endpoint differs with each interface version you would like to address. If for example you would like to address the web service interface of FACT-Finder 7.1, the following path is used:
$stringEscapeUtils.escapeHtml($body)FACT-Finder version 7.3 supports the endpoints ws71, ws70 und ws611.