+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

Reply via email to