Benjamin Tissoires 1eea102f26 openAPI: also handle `export` statement in the scripts 1 month ago
..
README.md 2969161afb - More whitelabeling. 2 months ago
generate_openapi.py 1eea102f26 openAPI: also handle `export` statement in the scripts 1 month ago

README.md

OpenAPI tools and doc generation

Open API generation

This folder contains a script (generate_openapi.py) that extracts the REST API of Wekan and exports it under the OpenAPI 2.0 specification (Swagger 2.0).

dependencies

calling the tool

python3 generate_openapi.py --release v1.65 > ../public/wekan_api.yml

Generating docs

Now that we have the OpenAPI, it's easy enough to convert the YAML file into some nice Markdown with shins and api2html, or even ReDoc:

api2html -c ../public/logo-header.png -o api.html ../public/wekan_api.yml

or

redoc-cli serve ../public/wekan_api.yml