+1 Regarding point 2: using Accept header to specify the API version, is this being done by any other known APIs? For my understanding Accept header is used for specify the media type [1].
[1] http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html On Sun, Oct 5, 2014 at 9:27 PM, Nirmal Fernando <nirmal070...@gmail.com> wrote: > All, > > Let's discuss how we could do $subject properly. AFAIS currently we don't > have any versioning in our REST API, but we have consumers of our REST API. > > 1. We can make the default API version to be the latest version, i.e. v2. > > So, if someone send a request to /<rootContext>/cartridges , it would find > /<rootContext>/v2/cartridges > > 2. Anyone can use the default API paths and still could request for a > specific version via HTTP Accept Header. > > Accept: application/vnd.stratos.v1+json > > > 3. Provide a migration guide for existing Clients. > > - If they want to use the old API, they need to specifically request for > the old API, by specifying the Accept header. > > 4. Mark v1 API as deprecated and announce that we'll remove the support > for it in the next release. > > Any other alternatives? > > > -- > Best Regards, > Nirmal > > Nirmal Fernando. > PPMC Member & Committer of Apache Stratos, > Senior Software Engineer, WSO2 Inc. > > Blog: http://nirmalfdo.blogspot.com/ > -- Imesh Gunaratne Technical Lead, WSO2 Committer & PMC Member, Apache Stratos
