rest-guide icon indicating copy to clipboard operation
rest-guide copied to clipboard

publish belgif common schemas directly on https URLs

Open pvdbosch opened this issue 5 years ago • 0 comments

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

pvdbosch avatar May 27 '20 16:05 pvdbosch