RESTAPI / WXM_RESTAPI configuration changes

parameter workdir

In version 2021.3 the OAS3 file cache (Swagger doc) of the API has been moved to the so-called working folder of the API, corresponding to the plugin parameter workdir (see https://crossmedia.atlassian.net/wiki/spaces/WD/pages/11764307/Appendix1+Configuration#Configure-the-plugin). Unfortunately the default value of this parameter historically refers to the system parameter user.dir which is not accessible from the Tomcat Application on some environments. The result is that the cache does not exist (the file couldn’t be written in the directory), which causes systematic regeneration (and therefore slowness in accessing the doc and increased resource consumption), but also big problems of conflicts during simultaneous access. The default value has therefore been changed in version 2021.5 to refer to user.home. Since the corresponding directory can be shared between several instances/application runtimes, especially for integration servers that are on the same machine, run by the same user, in order to have a folder specific to each instance, the default value also refers to the site name as a discriminating value.
It is important to pay attention to the value of this parameter, if you are running multiple environments simultaneously on the same machine with the same user without having configured a discriminating site name (I am thinking in particular of development machines), only if you want to use the swagger doc of course.