Ya, Imesh.. I was worrying about breaking existing clients (including our own UI /CLI) . Yes, I also felt the same after thinking a bit more and initiated a thread here: Versioning Stratos REST API
On Mon, Oct 6, 2014 at 10:45 AM, Imesh Gunaratne <im...@apache.org> wrote: > 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 > -- Best Regards, Nirmal Nirmal Fernando. PPMC Member & Committer of Apache Stratos, Senior Software Engineer, WSO2 Inc. Blog: http://nirmalfdo.blogspot.com/
