[katello-devel] API versioning

[Ohad Levy]

On 06/07/2012 04:55 PM, Dmitri Dolguikh wrote:

Great to see you here, are you back? :)

> +1 to using mime-header (not just any http header). Solves issues with
> proxies, etc, inherent when using custom headers. Definitely much better
> than including version in the url. It's probably not too serious of an
> issue atm - what version of api should be used in the absence of version
> information in the header? It could be the earliest one, but that's
> going to suck down the line. Perhaps we could switch to more recent
> versions of api used by default over time, after some grace period?

well, I would assume that at some new version at a point of time, we 
would change the api version, e.g.

SE v1, has only API v1
SE v2, has both API v1 and v2, v1 is the default
..
Se Vx has api v1 and v2, where v2 is now the default.


Ohad