QubitProducts / bamboo

HAProxy auto configuration and auto service discovery for Mesos Marathon
Apache License 2.0
794 stars 214 forks source link

Add REST API versioning #128

Open timoreimann opened 9 years ago

timoreimann commented 9 years ago

It'd be great to have API versioning for the REST interface so that clients can transition more smoothly between breaking changes and feature upgrades.

Personally, I'm a proponent of content negotiation for REST versioning (as opposed to the more commonly seen URL-based versioning) as it enables more fine-grained control over what parts of the API should evolve.

timoreimann commented 9 years ago

I'd be happy to provide a PR if there's agreement on the feature in general and an implementation approach in particular (i.e., content negotiation or something different).

j1n6 commented 9 years ago

I'm totally agree with your suggestion. I also prefer API versioning should not be part of the URI.

On 16 May 2015, at 15:30, Timo Reimann notifications@github.com wrote:

I'd be happy to provide a PR if there's agreement on the feature in general and an implementation approach in particular (i.e., content negotiation or something different).

— Reply to this email directly or view it on GitHub.

timoreimann commented 9 years ago

Glad to hear. I'll try to put something together then.