Hi, +1 for all the suggested points.
I would like to add few more to the list to be considered. 1. Provide useful error messages for back-end API exceptions. 2. Use of snake_case instead of camelCase in APIs. It is much more readable. 3. Support gzip compression. 4. Enable Cross-site Resource Sharing. We cannot make an API call to Stratos REST API through Javascript without this. 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/ -- Akila Ravihansa Perera Software Engineer, WSO2 Blog: http://ravihansa3000.blogspot.com