jaxrs: more Swagger documentation

Signed-off-by: Pierre-Alexandre Meyer <pierre@mouraf.org>