rest-guide
rest-guide copied to clipboard
publish belgif common schemas directly on https URLs
Publish the belgif OpenAPI schemas on https URLs, so they can be used without downloading and extracting a zip file.
To publish them on the belgif.be site in both YAML and JSON and with an index page, it would be easier to publish it using a dynamic application (e.g. JBoss using JAX-RS) rather than static pages. They should be published from the same sources on GitHub (either using GitHub action, or using webhook after release).
- URL structure (as discussed in #29):
problem/v1.1
problem/v1.0
problem/v1 => returns same YAML file as problem/v1.1
- redirection to latest version at domain level: http://example.org/person/identification => http://example.org/person/identification/v2
- or we could return a page with all available versions (v1/v2/...)
- content negotiation for YAML/JSON with Accept HTTP header