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/

Reply via email to