Hi Nirmal, I think that's the approach most of the well known APIs take [1, [2], [3]: - Document APIs by version - If version is not given in the context request is redirected to the latest version - If version is specified relevant API is invoked - Deprecate and remove old API versions according to a guideline mentioned in the documentation
[1] https://developers.facebook.com/docs/apps/versions [2] https://dev.twitter.com/rest/public [3] https://developer.linkedin.com/apis Thanks On Sun, Oct 5, 2014 at 5:54 PM, Nirmal Fernando <nirmal070...@gmail.com> wrote: > Another way to version the APIs is to use the Accept header with the > default URL (means default URL should always be the latest). But this would > make are current API users to change their clients to set the Accept header > to the correct version. > > On Sun, Oct 5, 2014 at 2:18 PM, Nirmal Fernando <nirmal070...@gmail.com> > wrote: > >> Hi Imesh, >> >> Since we didn't have a version in the context in 4.0, I think we can't >> redirect requests without a version to the latest, isn't it? Yes, plan is >> to introduce a version in the context and mark current APIs as deprecated. >> I'll start a separate thread on new REST API design. >> >> On Sat, Oct 4, 2014 at 11:12 PM, Imesh Gunaratne <im...@apache.org> >> wrote: >> >>> Have we version-ed the APIs? >>> IMO we should add the API version to the context (if not specified >>> redirected to latest) and keep the older versions of the API for some time >>> period before removing them. This should be clearly mentioned in the >>> documentation. >>> >>> On Fri, Oct 3, 2014 at 2:31 PM, Nirmal Fernando <nirmal070...@gmail.com> >>> wrote: >>> >>>> +1 >>>> >>>> On Fri, Oct 3, 2014 at 1:59 PM, Shiroshica Kulatilake <sh...@wso2.com> >>>> wrote: >>>> >>>>> Hi, >>>>> >>>>> Shouldn't we also enable the corresponding new rest endpoints in the >>>>> CLI >>>>> >>>>> Created a JIRA : https://issues.apache.org/jira/browse/STRATOS-869 >>>>> >>>>> Thank you, >>>>> Shiro >>>>> >>>>> On Fri, Oct 3, 2014 at 1:26 PM, Nirmal Fernando < >>>>> nirmal070...@gmail.com> wrote: >>>>> >>>>>> I think we should. >>>>>> >>>>>> On Fri, Oct 3, 2014 at 1:08 PM, Sajith Kariyawasam <saj...@wso2.com> >>>>>> wrote: >>>>>> >>>>>>> Do we focus on fixing following issues for M2 ? >>>>>>> >>>>>>> STRATOS-862 <https://issues.apache.org/jira/browse/STRATOS-862> >>>>>>> Kubernetes >>>>>>> scheduler needs to be restarted every 15 min or so. >>>>>>> STRATOS-860 <https://issues.apache.org/jira/browse/STRATOS-860> Error >>>>>>> when publishing to health topic in CEP extensions >>>>>>> STRATOS-858 <https://issues.apache.org/jira/browse/STRATOS-858> Error >>>>>>> in publishing artifact updated event >>>>>>> STRATOS-859 <https://issues.apache.org/jira/browse/STRATOS-859> >>>>>>> Unknown >>>>>>> host name exception when accessing VM instances via LB >>>>>>> >>>>>>> On Thu, Oct 2, 2014 at 9:24 AM, Manula Chathurika Thantriwatte < >>>>>>> manu...@wso2.com> wrote: >>>>>>> >>>>>>>> Hi Nirmal, >>>>>>>> >>>>>>>> Yes, CEP 3.1.0. Sorry for the typo. >>>>>>>> >>>>>>>> On Wed, Oct 1, 2014 at 10:56 PM, Nirmal Fernando < >>>>>>>> nirmal070...@gmail.com> wrote: >>>>>>>> >>>>>>>>> You meant CEP 3.1.0 ? >>>>>>>>> >>>>>>>>> On Wed, Oct 1, 2014 at 9:56 PM, Manula Chathurika Thantriwatte < >>>>>>>>> manu...@wso2.com> wrote: >>>>>>>>> >>>>>>>>>> Hi, >>>>>>>>>> >>>>>>>>>> Shall we integrate CEP 3.0.0 for M2. I can work on that. >>>>>>>>>> >>>>>>>>>> On Wed, Oct 1, 2014 at 11:19 AM, Shiroshica Kulatilake < >>>>>>>>>> sh...@wso2.com> wrote: >>>>>>>>>> >>>>>>>>>>> +1 for the REST API clean up >>>>>>>>>>> >>>>>>>>>>> Also, we should go for the first cut of the revamped UI >>>>>>>>>>> >>>>>>>>>>> On Wed, Oct 1, 2014 at 9:49 AM, Lakmal Warusawithana < >>>>>>>>>>> lak...@wso2.com> wrote: >>>>>>>>>>> >>>>>>>>>>>> >>>>>>>>>>>> >>>>>>>>>>>> On Wed, Oct 1, 2014 at 9:43 AM, Akila Ravihansa Perera < >>>>>>>>>>>> raviha...@wso2.com> wrote: >>>>>>>>>>>> >>>>>>>>>>>>> Shall we clean up our REST API to adhere to RESTful design as >>>>>>>>>>>>> well? >>>>>>>>>>>>> >>>>>>>>>>>>> >>>>>>>>>>>> +1 >>>>>>>>>>>> >>>>>>>>>>>> >>>>>>>>>>>>> On Wed, Oct 1, 2014 at 9:34 AM, Nirmal Fernando < >>>>>>>>>>>>> nirmal070...@gmail.com> wrote: >>>>>>>>>>>>> > Hi All, >>>>>>>>>>>>> > >>>>>>>>>>>>> > Since M1 developer preview is at its final testing stages, I >>>>>>>>>>>>> think it's best >>>>>>>>>>>>> > time to plan for M2 (early next week?). I think we should >>>>>>>>>>>>> focus on Python >>>>>>>>>>>>> > Cartridge Agent Integration in M2. Anything else ? >>>>>>>>>>>>> > >>>>>>>>>>>>> > -- >>>>>>>>>>>>> > 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 >>>>>>>>>>>>> >>>>>>>>>>>> >>>>>>>>>>>> >>>>>>>>>>>> >>>>>>>>>>>> -- >>>>>>>>>>>> Lakmal Warusawithana >>>>>>>>>>>> Vice President, Apache Stratos >>>>>>>>>>>> Director - Cloud Architecture; WSO2 Inc. >>>>>>>>>>>> Mobile : +94714289692 >>>>>>>>>>>> Blog : http://lakmalsview.blogspot.com/ >>>>>>>>>>>> >>>>>>>>>>>> >>>>>>>>>>> >>>>>>>>>>> >>>>>>>>>>> -- >>>>>>>>>>> Shiroshica Kulatilake >>>>>>>>>>> >>>>>>>>>>> Architect, >>>>>>>>>>> WSO2, Inc. http://wso2.com/ >>>>>>>>>>> Phone: +94 776523867 >>>>>>>>>>> >>>>>>>>>> >>>>>>>>>> >>>>>>>>>> >>>>>>>>>> -- >>>>>>>>>> Regards, >>>>>>>>>> Manula Chathurika Thantriwatte >>>>>>>>>> Software Engineer >>>>>>>>>> WSO2 Inc. : http://wso2.com >>>>>>>>>> lean . enterprise . middleware >>>>>>>>>> >>>>>>>>>> email : manu...@wso2.com / man...@apache.org >>>>>>>>>> phone : +94 772492511 >>>>>>>>>> blog : http://manulachathurika.blogspot.com/ >>>>>>>>>> >>>>>>>>>> >>>>>>>>>> >>>>>>>>>> >>>>>>>>> >>>>>>>>> >>>>>>>>> -- >>>>>>>>> Best Regards, >>>>>>>>> Nirmal >>>>>>>>> >>>>>>>>> Nirmal Fernando. >>>>>>>>> PPMC Member & Committer of Apache Stratos, >>>>>>>>> Senior Software Engineer, WSO2 Inc. >>>>>>>>> >>>>>>>>> Blog: http://nirmalfdo.blogspot.com/ >>>>>>>>> >>>>>>>> >>>>>>>> >>>>>>>> >>>>>>>> -- >>>>>>>> Regards, >>>>>>>> Manula Chathurika Thantriwatte >>>>>>>> Software Engineer >>>>>>>> WSO2 Inc. : http://wso2.com >>>>>>>> lean . enterprise . middleware >>>>>>>> >>>>>>>> email : manu...@wso2.com / man...@apache.org >>>>>>>> phone : +94 772492511 >>>>>>>> blog : http://manulachathurika.blogspot.com/ >>>>>>>> >>>>>>>> >>>>>>>> >>>>>>>> >>>>>>> >>>>>>> >>>>>>> -- >>>>>>> *Sajith Kariyawasam* >>>>>>> >>>>>>> >>>>>>> *Committer and PMC member, Apache Stratos,WSO2 Inc., http://wso2.com >>>>>>> <http://wso2.com>AMIE (SL)Mobile: +94772269575* >>>>>>> >>>>>> >>>>>> >>>>>> >>>>>> -- >>>>>> Best Regards, >>>>>> Nirmal >>>>>> >>>>>> Nirmal Fernando. >>>>>> PPMC Member & Committer of Apache Stratos, >>>>>> Senior Software Engineer, WSO2 Inc. >>>>>> >>>>>> Blog: http://nirmalfdo.blogspot.com/ >>>>>> >>>>> >>>>> >>>>> >>>>> -- >>>>> Shiroshica Kulatilake >>>>> >>>>> Architect, >>>>> WSO2, Inc. http://wso2.com/ >>>>> Phone: +94 776523867 >>>>> >>>> >>>> >>>> >>>> -- >>>> 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 >>> >> >> >> >> -- >> Best Regards, >> Nirmal >> >> Nirmal Fernando. >> PPMC Member & Committer of Apache Stratos, >> Senior Software Engineer, WSO2 Inc. >> >> Blog: http://nirmalfdo.blogspot.com/ >> > > > > -- > 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