Generate OpenAPI schema for REST API

[fm3]

With an openAPI schema the rest API client could be auto-generated.
We should investigate if there is a scala lib that auto-generates this from the play routes.
We should be able to blacklist some routes (not everything is supposed to be used except by webKnossos itself)

[jstriebel]

I just had a quick look, those seem to be candidates:

• https://index.scala-lang.org/swagger-api/swagger-play/swagger-play
• http://iheartradio.github.io/play-swagger/
• https://github.com/sohoffice/descriptive-play-swagger

[jstriebel]

@fm3 @youri-k Could one of you have a look if this might work? Just having the specs for a couple of endpoints would be already very helpful.

[jstriebel]

@fm3 The most important routes for the schema would be:

• GET /datasets/:organizationName/:dataSetName
• GET /annotations/:typ/:id/download
• POST /annotations/upload

Plus routes for dataset up- and download on the datastore.

PS: Another openAPI plugin (fork), which can be used to specify the returned schema:
https://github.com/kinoplan/swagger-play/

[jstriebel]

The datastore route /datasets/:organizationName/:dataSetName/layers/:dataLayerName/data works great for blob download. A schema for the upload route(s) would be great, though (POST on /datasets and /datasets/finishUpload?).