Canonical source for openapi.json/yaml spec

[LukeWeidenwalker]

@m-mohr I was wondering which URL is the canonical source to download the openapi.json/yaml spec for a specific version of the api programmatically?

I've come across the following possibilities, but neither seemed quite right:

• https://openeo.org/documentation/1.0/developers/api/openapi.yaml (however this only contains version 1.1.0 and there are no other versions to download)
• https://api.openeo.org/1.0.0/ (clicking the "download" button directly just downloads a blob, which based on some quick googling seems to be a browser internal representation coming from redoc, rather than an actual URL)
• https://github.com/Open-EO/openeo-api/releases/tag/1.1.0 has a zip of the entire repo
• https://raw.githubusercontent.com/Open-EO/openeo-api/1.1.0/openapi.yaml ?

Sorry if this is obvious or already documented somewhere - in that case I'd appreciate some directions - thanks!

[m-mohr]

We usually use https://raw.githubusercontent.com/Open-EO/openeo-api/1.1.0/openapi.yaml with 1.1.0 being replaced by the version number (1.0.0 and later).