[Koha-bugs] [Bug 15126]=?UTF-8?Q?=20REST=C2=A0API?=: Use newer version of Swagger2

[bugzilla-daemon at bugs.koha-community.org]

https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=15126

--- Comment #6 from Olli-Antti Kivilahti <olli-antti.kivilahti at jns.fi> ---
Also one thing regarding the structure of the api/v1/-directory:

Currently our api/v1/ looks like this:

.
├── hypnotoad.conf
├── hypnotoad.pid
├── app.cgi
├── swagger.json
├── doc
│   └── #Swagger-UI API discovery tool
│
├── auth_examples #REST API authentication code for different languages
│   │             #Discoverable from the Swagger-UI
│   └── ruby_example.rb.txt
│   └── ajax_example.sj.txt
#
#└── swagger  ##Could we add this?##
#    └── #swagger.json and subfolders and files

If you start adding the Swagger-spec linked files and subfolders here. The
directory structure will get very confusing. How about we add a directory where
to put the "swagger"-specification files?
I understand that the Swagger-UI might not be something which is aimed to be
included in the official Koha, but somebody will certainly want to run some
real API browsing/discovery service and this is a prefect place to do that.
However Swagger-UI works really well and it is improving all the time with a
lot of committers in already.
We could name the directory "swagger", or even better "OpenAPI", which is the
new name of the Swagger2-specification
    https://github.com/OAI/OpenAPI-Specification

-- 
You are receiving this mail because:
You are watching all bug changes.