Re: [Dev] Cleaning up ML REST API

[Thamali Wijewardhana]

Thanks Frank, Joseph for your comments and we have started working on the
swagger definition.

On Tue, Jan 5, 2016 at 3:19 PM, Nirmal Fernando  wrote:

> Thanks Frank. I sent an invite.
>
> On Tue, Jan 5, 2016 at 2:01 PM, Frank Leymann <
> frank.leym...@iaas.uni-stuttgart.de> wrote:
>
>> Hi Nimal, 3:30pm is fine. Talk to you then.
>>
>> Gruss/Regards,
>> Frank
>> (sent from my mobile - excuse typos & brevity)
>>
>> Am 05.01.2016 um 04:03 schrieb Nirmal Fernando :
>>
>> Hi Frank,
>>
>> Are you ok to have it at 3.30pm on 6th ? If not we can have it at 4pm
>> too.
>>
>> On Mon, Jan 4, 2016 at 9:43 PM, Frank Leymann  wrote:
>>
>>> ​Hi Nirmal,
>>>
>>> during our last call on the ML REST API we said that we want to continue
>>> our walkthru of the commented API document.  By mail we tentatively agreed
>>> on Wednesday, January 6th, 4pm Colombo time we another Skype Call or
>>> Hangout.  Should we take that time slot?  I would be available for an hour
>>> that time...​
>>>
>>>
>>> Best regards,
>>> Frank
>>>
>>> 2015-12-13 12:22 GMT+01:00 Frank Leymann :
>>>
 Dear Thamali,

 I added a bunch of comments.  For each of the methods (get, post,)
 I suggested modifications to your API that you may want to use as template
 for the other APIs; of course, I argued why I suggested individual pieces.
 I also started to make use of Swagger Paramters: and Definitions: sections
 to better ensure reuse of the different declarations of the API.

 Finally: I need to much better understand the ML data model. See my
 comments for clarification need I have :-)  This understanding is key to be
 able to recommend the use of "processing function resources" or not.

 I am looking forward to our discussion on Wednesday...


 Best regards,
 Frank

 2015-12-01 12:55 GMT+01:00 Thamali Wijewardhana :

> Link for the swagger definition:
>
>
> https://docs.google.com/a/wso2.com/document/d/1KYmXyuEFJMhFMy6p-SjRztVrgW8mr83LZR2U4BK4d-M/edit?usp=sharing
>
>
> On Tue, Dec 1, 2015 at 4:32 PM, Thamali Wijewardhana  > wrote:
>
>>
>>
>> On Thu, Nov 26, 2015 at 7:40 PM, Frank Leymann 
>> wrote:
>>
>>> Dear all, sorry for the delay  :-(
>>>
>>> What about one of the following time slots:
>>>
>>> Tuesday, Dec 1, 4pm Colombo Time
>>> Wednesday, Dec 2, 4pm Colombo Time
>>> Friday, Dec 4, 4pm Colombo Time
>>>
>>> I will be available later than 4pm but this won't be convenient for
>>> you in Colombo.
>>>
>>>
>>>
>>> Best regards,
>>> Frank
>>>
>>> 2015-11-25 8:43 GMT+01:00 Nirmal Fernando :
>>>
 Hi Frank,

 Could you please let us know few time slots?

 On Mon, Nov 23, 2015 at 9:29 AM, Nirmal Fernando 
 wrote:

> Absolutely. We'll wait till Frank confirms a time. Thanks.
>
> On Sun, Nov 22, 2015 at 10:18 PM, Sanjeewa Malalgoda <
> sanje...@wso2.com> wrote:
>
>> Hi nirmal,
>> please invite apim rest api team as well. we would like to join
>> this discussion.
>>
>> Thanks
>> sanjeewa.
>>
>> sent from my phone
>> On Nov 22, 2015 7:00 PM, "Nirmal Fernando" 
>> wrote:
>>
>>> Thanks Frank for the response. +1 for having a call. Could you
>>> please propose few time slots?
>>>
>>> On Sun, Nov 22, 2015 at 6:55 PM, Frank Leymann 
>>> wrote:
>>>
 Dear Thamali,

 we (APIM, ES Publisher,... teams) developed some guidelines on
 making all of our APIs more consistent. For example, versioning 
 (major,
 minor, patch) as part of the URL context etc.  Also, you are not 
 using PUT
 but always POST - this has some implications a bunch of REST-folks 
 are
 serious about. Similarly, the use of proper HTTP headers is a REST 
 issue to
 reduce the amount of data transferred, to avoid potential 
 concurrency
 problems etc.

 Should we have a call to discuss the API and check where we can
 help?



 Best regards,
 Frank

 2015-11-18 12:10 GMT+01:00 Nirmal Fernando :

> Thanks Thamali! Please try to generate the Swagger definition
> for ML API as the next step.
>
> On Wed, Nov 18, 2015 at 12:21 PM, Thamali Wijewardhana <
> tham...@wso2.com> wrote:
>
>> REST API standards 

Re: [Dev] Cleaning up ML REST API

[Nirmal Fernando]

Thanks Frank. I sent an invite.

On Tue, Jan 5, 2016 at 2:01 PM, Frank Leymann <
frank.leym...@iaas.uni-stuttgart.de> wrote:

> Hi Nimal, 3:30pm is fine. Talk to you then.
>
> Gruss/Regards,
> Frank
> (sent from my mobile - excuse typos & brevity)
>
> Am 05.01.2016 um 04:03 schrieb Nirmal Fernando :
>
> Hi Frank,
>
> Are you ok to have it at 3.30pm on 6th ? If not we can have it at 4pm too.
>
> On Mon, Jan 4, 2016 at 9:43 PM, Frank Leymann  wrote:
>
>> ​Hi Nirmal,
>>
>> during our last call on the ML REST API we said that we want to continue
>> our walkthru of the commented API document.  By mail we tentatively agreed
>> on Wednesday, January 6th, 4pm Colombo time we another Skype Call or
>> Hangout.  Should we take that time slot?  I would be available for an hour
>> that time...​
>>
>>
>> Best regards,
>> Frank
>>
>> 2015-12-13 12:22 GMT+01:00 Frank Leymann :
>>
>>> Dear Thamali,
>>>
>>> I added a bunch of comments.  For each of the methods (get, post,) I
>>> suggested modifications to your API that you may want to use as template
>>> for the other APIs; of course, I argued why I suggested individual pieces.
>>> I also started to make use of Swagger Paramters: and Definitions: sections
>>> to better ensure reuse of the different declarations of the API.
>>>
>>> Finally: I need to much better understand the ML data model. See my
>>> comments for clarification need I have :-)  This understanding is key to be
>>> able to recommend the use of "processing function resources" or not.
>>>
>>> I am looking forward to our discussion on Wednesday...
>>>
>>>
>>> Best regards,
>>> Frank
>>>
>>> 2015-12-01 12:55 GMT+01:00 Thamali Wijewardhana :
>>>
 Link for the swagger definition:


 https://docs.google.com/a/wso2.com/document/d/1KYmXyuEFJMhFMy6p-SjRztVrgW8mr83LZR2U4BK4d-M/edit?usp=sharing


 On Tue, Dec 1, 2015 at 4:32 PM, Thamali Wijewardhana 
 wrote:

>
>
> On Thu, Nov 26, 2015 at 7:40 PM, Frank Leymann  wrote:
>
>> Dear all, sorry for the delay  :-(
>>
>> What about one of the following time slots:
>>
>> Tuesday, Dec 1, 4pm Colombo Time
>> Wednesday, Dec 2, 4pm Colombo Time
>> Friday, Dec 4, 4pm Colombo Time
>>
>> I will be available later than 4pm but this won't be convenient for
>> you in Colombo.
>>
>>
>>
>> Best regards,
>> Frank
>>
>> 2015-11-25 8:43 GMT+01:00 Nirmal Fernando :
>>
>>> Hi Frank,
>>>
>>> Could you please let us know few time slots?
>>>
>>> On Mon, Nov 23, 2015 at 9:29 AM, Nirmal Fernando 
>>> wrote:
>>>
 Absolutely. We'll wait till Frank confirms a time. Thanks.

 On Sun, Nov 22, 2015 at 10:18 PM, Sanjeewa Malalgoda <
 sanje...@wso2.com> wrote:

> Hi nirmal,
> please invite apim rest api team as well. we would like to join
> this discussion.
>
> Thanks
> sanjeewa.
>
> sent from my phone
> On Nov 22, 2015 7:00 PM, "Nirmal Fernando" 
> wrote:
>
>> Thanks Frank for the response. +1 for having a call. Could you
>> please propose few time slots?
>>
>> On Sun, Nov 22, 2015 at 6:55 PM, Frank Leymann 
>> wrote:
>>
>>> Dear Thamali,
>>>
>>> we (APIM, ES Publisher,... teams) developed some guidelines on
>>> making all of our APIs more consistent. For example, versioning 
>>> (major,
>>> minor, patch) as part of the URL context etc.  Also, you are not 
>>> using PUT
>>> but always POST - this has some implications a bunch of REST-folks 
>>> are
>>> serious about. Similarly, the use of proper HTTP headers is a REST 
>>> issue to
>>> reduce the amount of data transferred, to avoid potential 
>>> concurrency
>>> problems etc.
>>>
>>> Should we have a call to discuss the API and check where we can
>>> help?
>>>
>>>
>>>
>>> Best regards,
>>> Frank
>>>
>>> 2015-11-18 12:10 GMT+01:00 Nirmal Fernando :
>>>
 Thanks Thamali! Please try to generate the Swagger definition
 for ML API as the next step.

 On Wed, Nov 18, 2015 at 12:21 PM, Thamali Wijewardhana <
 tham...@wso2.com> wrote:

> REST API standards define the way to produce a RESTful API.
> For an API to become a RESTful API, it should confirm to those 
> REST
> standards.This document includes a set of  improvements to make 
> the WSO2
> API, a RESTful API.
>
>
>

Re: [Dev] Cleaning up ML REST API

[Nirmal Fernando]

Hi Frank,

Are you ok to have it at 3.30pm on 6th ? If not we can have it at 4pm too.

On Mon, Jan 4, 2016 at 9:43 PM, Frank Leymann  wrote:

> ​Hi Nirmal,
>
> during our last call on the ML REST API we said that we want to continue
> our walkthru of the commented API document.  By mail we tentatively agreed
> on Wednesday, January 6th, 4pm Colombo time we another Skype Call or
> Hangout.  Should we take that time slot?  I would be available for an hour
> that time...​
>
>
> Best regards,
> Frank
>
> 2015-12-13 12:22 GMT+01:00 Frank Leymann :
>
>> Dear Thamali,
>>
>> I added a bunch of comments.  For each of the methods (get, post,) I
>> suggested modifications to your API that you may want to use as template
>> for the other APIs; of course, I argued why I suggested individual pieces.
>> I also started to make use of Swagger Paramters: and Definitions: sections
>> to better ensure reuse of the different declarations of the API.
>>
>> Finally: I need to much better understand the ML data model. See my
>> comments for clarification need I have :-)  This understanding is key to be
>> able to recommend the use of "processing function resources" or not.
>>
>> I am looking forward to our discussion on Wednesday...
>>
>>
>> Best regards,
>> Frank
>>
>> 2015-12-01 12:55 GMT+01:00 Thamali Wijewardhana :
>>
>>> Link for the swagger definition:
>>>
>>>
>>> https://docs.google.com/a/wso2.com/document/d/1KYmXyuEFJMhFMy6p-SjRztVrgW8mr83LZR2U4BK4d-M/edit?usp=sharing
>>>
>>>
>>> On Tue, Dec 1, 2015 at 4:32 PM, Thamali Wijewardhana 
>>> wrote:
>>>


 On Thu, Nov 26, 2015 at 7:40 PM, Frank Leymann  wrote:

> Dear all, sorry for the delay  :-(
>
> What about one of the following time slots:
>
> Tuesday, Dec 1, 4pm Colombo Time
> Wednesday, Dec 2, 4pm Colombo Time
> Friday, Dec 4, 4pm Colombo Time
>
> I will be available later than 4pm but this won't be convenient for
> you in Colombo.
>
>
>
> Best regards,
> Frank
>
> 2015-11-25 8:43 GMT+01:00 Nirmal Fernando :
>
>> Hi Frank,
>>
>> Could you please let us know few time slots?
>>
>> On Mon, Nov 23, 2015 at 9:29 AM, Nirmal Fernando 
>> wrote:
>>
>>> Absolutely. We'll wait till Frank confirms a time. Thanks.
>>>
>>> On Sun, Nov 22, 2015 at 10:18 PM, Sanjeewa Malalgoda <
>>> sanje...@wso2.com> wrote:
>>>
 Hi nirmal,
 please invite apim rest api team as well. we would like to join
 this discussion.

 Thanks
 sanjeewa.

 sent from my phone
 On Nov 22, 2015 7:00 PM, "Nirmal Fernando"  wrote:

> Thanks Frank for the response. +1 for having a call. Could you
> please propose few time slots?
>
> On Sun, Nov 22, 2015 at 6:55 PM, Frank Leymann 
> wrote:
>
>> Dear Thamali,
>>
>> we (APIM, ES Publisher,... teams) developed some guidelines on
>> making all of our APIs more consistent. For example, versioning 
>> (major,
>> minor, patch) as part of the URL context etc.  Also, you are not 
>> using PUT
>> but always POST - this has some implications a bunch of REST-folks 
>> are
>> serious about. Similarly, the use of proper HTTP headers is a REST 
>> issue to
>> reduce the amount of data transferred, to avoid potential concurrency
>> problems etc.
>>
>> Should we have a call to discuss the API and check where we can
>> help?
>>
>>
>>
>> Best regards,
>> Frank
>>
>> 2015-11-18 12:10 GMT+01:00 Nirmal Fernando :
>>
>>> Thanks Thamali! Please try to generate the Swagger definition
>>> for ML API as the next step.
>>>
>>> On Wed, Nov 18, 2015 at 12:21 PM, Thamali Wijewardhana <
>>> tham...@wso2.com> wrote:
>>>
 REST API standards define the way to produce a RESTful API. For
 an API to become a RESTful API, it should confirm to those REST
 standards.This document includes a set of  improvements to make 
 the WSO2
 API, a RESTful API.



 https://docs.google.com/spreadsheets/d/1HYiS-TpqYaZTtBLLSIeYZ_nvZkbt7zAFwetnHLe4vg8/edit#gid=0



>>>
>>>
>>> --
>>>
>>> Thanks & regards,
>>> Nirmal
>>>
>>> Team Lead - WSO2 Machine Learner
>>> Associate Technical Lead - Data Technologies Team, WSO2 Inc.
>>> Mobile: +94715779733
>>> Blog: http://nirmalfdo.blogspot.com/
>>>
>>>
>>>
>>

Re: [Dev] Cleaning up ML REST API

[Nirmal Fernando]

Thanks a lot Frank for taking your time to review a 45pg doc. :) I've
replied to few of your comments.

Unfortunately, I've got an event to attend this Wednesday. Currently, I
have Monday and Tuesday free on my calendar. Please let me know if one of
those days works for you.

On Sun, Dec 13, 2015 at 4:52 PM, Frank Leymann  wrote:

> Dear Thamali,
>
> I added a bunch of comments.  For each of the methods (get, post,) I
> suggested modifications to your API that you may want to use as template
> for the other APIs; of course, I argued why I suggested individual pieces.
> I also started to make use of Swagger Paramters: and Definitions: sections
> to better ensure reuse of the different declarations of the API.
>
> Finally: I need to much better understand the ML data model. See my
> comments for clarification need I have :-)  This understanding is key to be
> able to recommend the use of "processing function resources" or not.
>
> I am looking forward to our discussion on Wednesday...
>
>
> Best regards,
> Frank
>
> 2015-12-01 12:55 GMT+01:00 Thamali Wijewardhana :
>
>> Link for the swagger definition:
>>
>>
>> https://docs.google.com/a/wso2.com/document/d/1KYmXyuEFJMhFMy6p-SjRztVrgW8mr83LZR2U4BK4d-M/edit?usp=sharing
>>
>>
>> On Tue, Dec 1, 2015 at 4:32 PM, Thamali Wijewardhana 
>> wrote:
>>
>>>
>>>
>>> On Thu, Nov 26, 2015 at 7:40 PM, Frank Leymann  wrote:
>>>
 Dear all, sorry for the delay  :-(

 What about one of the following time slots:

 Tuesday, Dec 1, 4pm Colombo Time
 Wednesday, Dec 2, 4pm Colombo Time
 Friday, Dec 4, 4pm Colombo Time

 I will be available later than 4pm but this won't be convenient for you
 in Colombo.



 Best regards,
 Frank

 2015-11-25 8:43 GMT+01:00 Nirmal Fernando :

> Hi Frank,
>
> Could you please let us know few time slots?
>
> On Mon, Nov 23, 2015 at 9:29 AM, Nirmal Fernando 
> wrote:
>
>> Absolutely. We'll wait till Frank confirms a time. Thanks.
>>
>> On Sun, Nov 22, 2015 at 10:18 PM, Sanjeewa Malalgoda <
>> sanje...@wso2.com> wrote:
>>
>>> Hi nirmal,
>>> please invite apim rest api team as well. we would like to join this
>>> discussion.
>>>
>>> Thanks
>>> sanjeewa.
>>>
>>> sent from my phone
>>> On Nov 22, 2015 7:00 PM, "Nirmal Fernando"  wrote:
>>>
 Thanks Frank for the response. +1 for having a call. Could you
 please propose few time slots?

 On Sun, Nov 22, 2015 at 6:55 PM, Frank Leymann 
 wrote:

> Dear Thamali,
>
> we (APIM, ES Publisher,... teams) developed some guidelines on
> making all of our APIs more consistent. For example, versioning 
> (major,
> minor, patch) as part of the URL context etc.  Also, you are not 
> using PUT
> but always POST - this has some implications a bunch of REST-folks are
> serious about. Similarly, the use of proper HTTP headers is a REST 
> issue to
> reduce the amount of data transferred, to avoid potential concurrency
> problems etc.
>
> Should we have a call to discuss the API and check where we can
> help?
>
>
>
> Best regards,
> Frank
>
> 2015-11-18 12:10 GMT+01:00 Nirmal Fernando :
>
>> Thanks Thamali! Please try to generate the Swagger definition for
>> ML API as the next step.
>>
>> On Wed, Nov 18, 2015 at 12:21 PM, Thamali Wijewardhana <
>> tham...@wso2.com> wrote:
>>
>>> REST API standards define the way to produce a RESTful API. For
>>> an API to become a RESTful API, it should confirm to those REST
>>> standards.This document includes a set of  improvements to make the 
>>> WSO2
>>> API, a RESTful API.
>>>
>>>
>>>
>>> https://docs.google.com/spreadsheets/d/1HYiS-TpqYaZTtBLLSIeYZ_nvZkbt7zAFwetnHLe4vg8/edit#gid=0
>>>
>>>
>>>
>>
>>
>> --
>>
>> Thanks & regards,
>> Nirmal
>>
>> Team Lead - WSO2 Machine Learner
>> Associate Technical Lead - Data Technologies Team, WSO2 Inc.
>> Mobile: +94715779733
>> Blog: http://nirmalfdo.blogspot.com/
>>
>>
>>
>


 --

 Thanks & regards,
 Nirmal

 Team Lead - WSO2 Machine Learner
 Associate Technical Lead - Data Technologies Team, WSO2 Inc.
 Mobile: +94715779733
 Blog: http://nirmalfdo.blogspot.com/



>>
>>
>> --
>>
>> Thanks & regards,
>> Nirmal
>>

Re: [Dev] Cleaning up ML REST API

[Nirmal Fernando]

Hi Frank,

I'm celebrating X'mas so probably not be around :-( Shall we synch up in
the new year? We're on holiday till 4th Jan :)

On Sun, Dec 13, 2015 at 10:23 PM, Frank Leymann  wrote:

> Hi Nirmal,
>
> sure, if you can't make Wednesday we should defer the meeting.  I am fully
> booked on Monday and Tuesday, and after Wednesday I have a bunch of
> personal commitments.
>
> I would be available on the 25th (yes! it's Xmas, but I am more than happy
> to discuss with you!), but I am not sure whether you are working that
> day... Otherwise, I could make Tuesday the 29th (4pm Colombo time) or
> Wednesday 30th (2:30pm Colombo time).
>
> Just let me know :-))
>
>
> Best regards,
> Frank
>
> 2015-12-13 13:00 GMT+01:00 Nirmal Fernando :
>
>> Thanks a lot Frank for taking your time to review a 45pg doc. :) I've
>> replied to few of your comments.
>>
>> Unfortunately, I've got an event to attend this Wednesday. Currently, I
>> have Monday and Tuesday free on my calendar. Please let me know if one of
>> those days works for you.
>>
>> On Sun, Dec 13, 2015 at 4:52 PM, Frank Leymann  wrote:
>>
>>> Dear Thamali,
>>>
>>> I added a bunch of comments.  For each of the methods (get, post,) I
>>> suggested modifications to your API that you may want to use as template
>>> for the other APIs; of course, I argued why I suggested individual pieces.
>>> I also started to make use of Swagger Paramters: and Definitions: sections
>>> to better ensure reuse of the different declarations of the API.
>>>
>>> Finally: I need to much better understand the ML data model. See my
>>> comments for clarification need I have :-)  This understanding is key to be
>>> able to recommend the use of "processing function resources" or not.
>>>
>>> I am looking forward to our discussion on Wednesday...
>>>
>>>
>>> Best regards,
>>> Frank
>>>
>>> 2015-12-01 12:55 GMT+01:00 Thamali Wijewardhana :
>>>
 Link for the swagger definition:


 https://docs.google.com/a/wso2.com/document/d/1KYmXyuEFJMhFMy6p-SjRztVrgW8mr83LZR2U4BK4d-M/edit?usp=sharing


 On Tue, Dec 1, 2015 at 4:32 PM, Thamali Wijewardhana 
 wrote:

>
>
> On Thu, Nov 26, 2015 at 7:40 PM, Frank Leymann  wrote:
>
>> Dear all, sorry for the delay  :-(
>>
>> What about one of the following time slots:
>>
>> Tuesday, Dec 1, 4pm Colombo Time
>> Wednesday, Dec 2, 4pm Colombo Time
>> Friday, Dec 4, 4pm Colombo Time
>>
>> I will be available later than 4pm but this won't be convenient for
>> you in Colombo.
>>
>>
>>
>> Best regards,
>> Frank
>>
>> 2015-11-25 8:43 GMT+01:00 Nirmal Fernando :
>>
>>> Hi Frank,
>>>
>>> Could you please let us know few time slots?
>>>
>>> On Mon, Nov 23, 2015 at 9:29 AM, Nirmal Fernando 
>>> wrote:
>>>
 Absolutely. We'll wait till Frank confirms a time. Thanks.

 On Sun, Nov 22, 2015 at 10:18 PM, Sanjeewa Malalgoda <
 sanje...@wso2.com> wrote:

> Hi nirmal,
> please invite apim rest api team as well. we would like to join
> this discussion.
>
> Thanks
> sanjeewa.
>
> sent from my phone
> On Nov 22, 2015 7:00 PM, "Nirmal Fernando" 
> wrote:
>
>> Thanks Frank for the response. +1 for having a call. Could you
>> please propose few time slots?
>>
>> On Sun, Nov 22, 2015 at 6:55 PM, Frank Leymann 
>> wrote:
>>
>>> Dear Thamali,
>>>
>>> we (APIM, ES Publisher,... teams) developed some guidelines on
>>> making all of our APIs more consistent. For example, versioning 
>>> (major,
>>> minor, patch) as part of the URL context etc.  Also, you are not 
>>> using PUT
>>> but always POST - this has some implications a bunch of REST-folks 
>>> are
>>> serious about. Similarly, the use of proper HTTP headers is a REST 
>>> issue to
>>> reduce the amount of data transferred, to avoid potential 
>>> concurrency
>>> problems etc.
>>>
>>> Should we have a call to discuss the API and check where we can
>>> help?
>>>
>>>
>>>
>>> Best regards,
>>> Frank
>>>
>>> 2015-11-18 12:10 GMT+01:00 Nirmal Fernando :
>>>
 Thanks Thamali! Please try to generate the Swagger definition
 for ML API as the next step.

 On Wed, Nov 18, 2015 at 12:21 PM, Thamali Wijewardhana <
 tham...@wso2.com> wrote:

> REST API standards define the way to produce a RESTful API.
> For an API to become a RESTful API, it should 

Re: [Dev] Cleaning up ML REST API

[Thamali Wijewardhana]

On Thu, Nov 26, 2015 at 7:40 PM, Frank Leymann  wrote:

> Dear all, sorry for the delay  :-(
>
> What about one of the following time slots:
>
> Tuesday, Dec 1, 4pm Colombo Time
> Wednesday, Dec 2, 4pm Colombo Time
> Friday, Dec 4, 4pm Colombo Time
>
> I will be available later than 4pm but this won't be convenient for you in
> Colombo.
>
>
>
> Best regards,
> Frank
>
> 2015-11-25 8:43 GMT+01:00 Nirmal Fernando :
>
>> Hi Frank,
>>
>> Could you please let us know few time slots?
>>
>> On Mon, Nov 23, 2015 at 9:29 AM, Nirmal Fernando  wrote:
>>
>>> Absolutely. We'll wait till Frank confirms a time. Thanks.
>>>
>>> On Sun, Nov 22, 2015 at 10:18 PM, Sanjeewa Malalgoda 
>>> wrote:
>>>
 Hi nirmal,
 please invite apim rest api team as well. we would like to join this
 discussion.

 Thanks
 sanjeewa.

 sent from my phone
 On Nov 22, 2015 7:00 PM, "Nirmal Fernando"  wrote:

> Thanks Frank for the response. +1 for having a call. Could you please
> propose few time slots?
>
> On Sun, Nov 22, 2015 at 6:55 PM, Frank Leymann  wrote:
>
>> Dear Thamali,
>>
>> we (APIM, ES Publisher,... teams) developed some guidelines on making
>> all of our APIs more consistent. For example, versioning (major, minor,
>> patch) as part of the URL context etc.  Also, you are not using PUT but
>> always POST - this has some implications a bunch of REST-folks are 
>> serious
>> about. Similarly, the use of proper HTTP headers is a REST issue to 
>> reduce
>> the amount of data transferred, to avoid potential concurrency problems
>> etc.
>>
>> Should we have a call to discuss the API and check where we can help?
>>
>>
>>
>> Best regards,
>> Frank
>>
>> 2015-11-18 12:10 GMT+01:00 Nirmal Fernando :
>>
>>> Thanks Thamali! Please try to generate the Swagger definition for ML
>>> API as the next step.
>>>
>>> On Wed, Nov 18, 2015 at 12:21 PM, Thamali Wijewardhana <
>>> tham...@wso2.com> wrote:
>>>
 REST API standards define the way to produce a RESTful API. For an
 API to become a RESTful API, it should confirm to those REST
 standards.This document includes a set of  improvements to make the 
 WSO2
 API, a RESTful API.



 https://docs.google.com/spreadsheets/d/1HYiS-TpqYaZTtBLLSIeYZ_nvZkbt7zAFwetnHLe4vg8/edit#gid=0



>>>
>>>
>>> --
>>>
>>> Thanks & regards,
>>> Nirmal
>>>
>>> Team Lead - WSO2 Machine Learner
>>> Associate Technical Lead - Data Technologies Team, WSO2 Inc.
>>> Mobile: +94715779733
>>> Blog: http://nirmalfdo.blogspot.com/
>>>
>>>
>>>
>>
>
>
> --
>
> Thanks & regards,
> Nirmal
>
> Team Lead - WSO2 Machine Learner
> Associate Technical Lead - Data Technologies Team, WSO2 Inc.
> Mobile: +94715779733
> Blog: http://nirmalfdo.blogspot.com/
>
>
>
>>>
>>>
>>> --
>>>
>>> Thanks & regards,
>>> Nirmal
>>>
>>> Team Lead - WSO2 Machine Learner
>>> Associate Technical Lead - Data Technologies Team, WSO2 Inc.
>>> Mobile: +94715779733
>>> Blog: http://nirmalfdo.blogspot.com/
>>>
>>>
>>>
>>
>>
>> --
>>
>> Thanks & regards,
>> Nirmal
>>
>> Team Lead - WSO2 Machine Learner
>> Associate Technical Lead - Data Technologies Team, WSO2 Inc.
>> Mobile: +94715779733
>> Blog: http://nirmalfdo.blogspot.com/
>>
>>
>>
>


swagger.yml
Description: application/yaml
___
Dev mailing list
Dev@wso2.org
http://wso2.org/cgi-bin/mailman/listinfo/dev

Re: [Dev] Cleaning up ML REST API

[Thamali Wijewardhana]

Link for the swagger definition:

https://docs.google.com/a/wso2.com/document/d/1KYmXyuEFJMhFMy6p-SjRztVrgW8mr83LZR2U4BK4d-M/edit?usp=sharing


On Tue, Dec 1, 2015 at 4:32 PM, Thamali Wijewardhana 
wrote:

>
>
> On Thu, Nov 26, 2015 at 7:40 PM, Frank Leymann  wrote:
>
>> Dear all, sorry for the delay  :-(
>>
>> What about one of the following time slots:
>>
>> Tuesday, Dec 1, 4pm Colombo Time
>> Wednesday, Dec 2, 4pm Colombo Time
>> Friday, Dec 4, 4pm Colombo Time
>>
>> I will be available later than 4pm but this won't be convenient for you
>> in Colombo.
>>
>>
>>
>> Best regards,
>> Frank
>>
>> 2015-11-25 8:43 GMT+01:00 Nirmal Fernando :
>>
>>> Hi Frank,
>>>
>>> Could you please let us know few time slots?
>>>
>>> On Mon, Nov 23, 2015 at 9:29 AM, Nirmal Fernando 
>>> wrote:
>>>
 Absolutely. We'll wait till Frank confirms a time. Thanks.

 On Sun, Nov 22, 2015 at 10:18 PM, Sanjeewa Malalgoda  wrote:

> Hi nirmal,
> please invite apim rest api team as well. we would like to join this
> discussion.
>
> Thanks
> sanjeewa.
>
> sent from my phone
> On Nov 22, 2015 7:00 PM, "Nirmal Fernando"  wrote:
>
>> Thanks Frank for the response. +1 for having a call. Could you please
>> propose few time slots?
>>
>> On Sun, Nov 22, 2015 at 6:55 PM, Frank Leymann 
>> wrote:
>>
>>> Dear Thamali,
>>>
>>> we (APIM, ES Publisher,... teams) developed some guidelines on
>>> making all of our APIs more consistent. For example, versioning (major,
>>> minor, patch) as part of the URL context etc.  Also, you are not using 
>>> PUT
>>> but always POST - this has some implications a bunch of REST-folks are
>>> serious about. Similarly, the use of proper HTTP headers is a REST 
>>> issue to
>>> reduce the amount of data transferred, to avoid potential concurrency
>>> problems etc.
>>>
>>> Should we have a call to discuss the API and check where we can help?
>>>
>>>
>>>
>>> Best regards,
>>> Frank
>>>
>>> 2015-11-18 12:10 GMT+01:00 Nirmal Fernando :
>>>
 Thanks Thamali! Please try to generate the Swagger definition for
 ML API as the next step.

 On Wed, Nov 18, 2015 at 12:21 PM, Thamali Wijewardhana <
 tham...@wso2.com> wrote:

> REST API standards define the way to produce a RESTful API. For an
> API to become a RESTful API, it should confirm to those REST
> standards.This document includes a set of  improvements to make the 
> WSO2
> API, a RESTful API.
>
>
>
> https://docs.google.com/spreadsheets/d/1HYiS-TpqYaZTtBLLSIeYZ_nvZkbt7zAFwetnHLe4vg8/edit#gid=0
>
>
>


 --

 Thanks & regards,
 Nirmal

 Team Lead - WSO2 Machine Learner
 Associate Technical Lead - Data Technologies Team, WSO2 Inc.
 Mobile: +94715779733
 Blog: http://nirmalfdo.blogspot.com/



>>>
>>
>>
>> --
>>
>> Thanks & regards,
>> Nirmal
>>
>> Team Lead - WSO2 Machine Learner
>> Associate Technical Lead - Data Technologies Team, WSO2 Inc.
>> Mobile: +94715779733
>> Blog: http://nirmalfdo.blogspot.com/
>>
>>
>>


 --

 Thanks & regards,
 Nirmal

 Team Lead - WSO2 Machine Learner
 Associate Technical Lead - Data Technologies Team, WSO2 Inc.
 Mobile: +94715779733
 Blog: http://nirmalfdo.blogspot.com/



>>>
>>>
>>> --
>>>
>>> Thanks & regards,
>>> Nirmal
>>>
>>> Team Lead - WSO2 Machine Learner
>>> Associate Technical Lead - Data Technologies Team, WSO2 Inc.
>>> Mobile: +94715779733
>>> Blog: http://nirmalfdo.blogspot.com/
>>>
>>>
>>>
>>
>
___
Dev mailing list
Dev@wso2.org
http://wso2.org/cgi-bin/mailman/listinfo/dev

Re: [Dev] Cleaning up ML REST API

[Nirmal Fernando]

Hi Frank,

Could you please let us know few time slots?

On Mon, Nov 23, 2015 at 9:29 AM, Nirmal Fernando  wrote:

> Absolutely. We'll wait till Frank confirms a time. Thanks.
>
> On Sun, Nov 22, 2015 at 10:18 PM, Sanjeewa Malalgoda 
> wrote:
>
>> Hi nirmal,
>> please invite apim rest api team as well. we would like to join this
>> discussion.
>>
>> Thanks
>> sanjeewa.
>>
>> sent from my phone
>> On Nov 22, 2015 7:00 PM, "Nirmal Fernando"  wrote:
>>
>>> Thanks Frank for the response. +1 for having a call. Could you please
>>> propose few time slots?
>>>
>>> On Sun, Nov 22, 2015 at 6:55 PM, Frank Leymann  wrote:
>>>
 Dear Thamali,

 we (APIM, ES Publisher,... teams) developed some guidelines on making
 all of our APIs more consistent. For example, versioning (major, minor,
 patch) as part of the URL context etc.  Also, you are not using PUT but
 always POST - this has some implications a bunch of REST-folks are serious
 about. Similarly, the use of proper HTTP headers is a REST issue to reduce
 the amount of data transferred, to avoid potential concurrency problems
 etc.

 Should we have a call to discuss the API and check where we can help?



 Best regards,
 Frank

 2015-11-18 12:10 GMT+01:00 Nirmal Fernando :

> Thanks Thamali! Please try to generate the Swagger definition for ML
> API as the next step.
>
> On Wed, Nov 18, 2015 at 12:21 PM, Thamali Wijewardhana <
> tham...@wso2.com> wrote:
>
>> REST API standards define the way to produce a RESTful API. For an
>> API to become a RESTful API, it should confirm to those REST
>> standards.This document includes a set of  improvements to make the WSO2
>> API, a RESTful API.
>>
>>
>>
>> https://docs.google.com/spreadsheets/d/1HYiS-TpqYaZTtBLLSIeYZ_nvZkbt7zAFwetnHLe4vg8/edit#gid=0
>>
>>
>>
>
>
> --
>
> Thanks & regards,
> Nirmal
>
> Team Lead - WSO2 Machine Learner
> Associate Technical Lead - Data Technologies Team, WSO2 Inc.
> Mobile: +94715779733
> Blog: http://nirmalfdo.blogspot.com/
>
>
>

>>>
>>>
>>> --
>>>
>>> Thanks & regards,
>>> Nirmal
>>>
>>> Team Lead - WSO2 Machine Learner
>>> Associate Technical Lead - Data Technologies Team, WSO2 Inc.
>>> Mobile: +94715779733
>>> Blog: http://nirmalfdo.blogspot.com/
>>>
>>>
>>>
>
>
> --
>
> Thanks & regards,
> Nirmal
>
> Team Lead - WSO2 Machine Learner
> Associate Technical Lead - Data Technologies Team, WSO2 Inc.
> Mobile: +94715779733
> Blog: http://nirmalfdo.blogspot.com/
>
>
>


-- 

Thanks & regards,
Nirmal

Team Lead - WSO2 Machine Learner
Associate Technical Lead - Data Technologies Team, WSO2 Inc.
Mobile: +94715779733
Blog: http://nirmalfdo.blogspot.com/
___
Dev mailing list
Dev@wso2.org
http://wso2.org/cgi-bin/mailman/listinfo/dev

Re: [Dev] Cleaning up ML REST API

[Nirmal Fernando]

Absolutely. We'll wait till Frank confirms a time. Thanks.

On Sun, Nov 22, 2015 at 10:18 PM, Sanjeewa Malalgoda 
wrote:

> Hi nirmal,
> please invite apim rest api team as well. we would like to join this
> discussion.
>
> Thanks
> sanjeewa.
>
> sent from my phone
> On Nov 22, 2015 7:00 PM, "Nirmal Fernando"  wrote:
>
>> Thanks Frank for the response. +1 for having a call. Could you please
>> propose few time slots?
>>
>> On Sun, Nov 22, 2015 at 6:55 PM, Frank Leymann  wrote:
>>
>>> Dear Thamali,
>>>
>>> we (APIM, ES Publisher,... teams) developed some guidelines on making
>>> all of our APIs more consistent. For example, versioning (major, minor,
>>> patch) as part of the URL context etc.  Also, you are not using PUT but
>>> always POST - this has some implications a bunch of REST-folks are serious
>>> about. Similarly, the use of proper HTTP headers is a REST issue to reduce
>>> the amount of data transferred, to avoid potential concurrency problems
>>> etc.
>>>
>>> Should we have a call to discuss the API and check where we can help?
>>>
>>>
>>>
>>> Best regards,
>>> Frank
>>>
>>> 2015-11-18 12:10 GMT+01:00 Nirmal Fernando :
>>>
 Thanks Thamali! Please try to generate the Swagger definition for ML
 API as the next step.

 On Wed, Nov 18, 2015 at 12:21 PM, Thamali Wijewardhana <
 tham...@wso2.com> wrote:

> REST API standards define the way to produce a RESTful API. For an API
> to become a RESTful API, it should confirm to those REST  standards.This
> document includes a set of  improvements to make the WSO2 API, a RESTful
> API.
>
>
>
> https://docs.google.com/spreadsheets/d/1HYiS-TpqYaZTtBLLSIeYZ_nvZkbt7zAFwetnHLe4vg8/edit#gid=0
>
>
>


 --

 Thanks & regards,
 Nirmal

 Team Lead - WSO2 Machine Learner
 Associate Technical Lead - Data Technologies Team, WSO2 Inc.
 Mobile: +94715779733
 Blog: http://nirmalfdo.blogspot.com/



>>>
>>
>>
>> --
>>
>> Thanks & regards,
>> Nirmal
>>
>> Team Lead - WSO2 Machine Learner
>> Associate Technical Lead - Data Technologies Team, WSO2 Inc.
>> Mobile: +94715779733
>> Blog: http://nirmalfdo.blogspot.com/
>>
>>
>>


-- 

Thanks & regards,
Nirmal

Team Lead - WSO2 Machine Learner
Associate Technical Lead - Data Technologies Team, WSO2 Inc.
Mobile: +94715779733
Blog: http://nirmalfdo.blogspot.com/
___
Dev mailing list
Dev@wso2.org
http://wso2.org/cgi-bin/mailman/listinfo/dev

Re: [Dev] Cleaning up ML REST API

[Nirmal Fernando]

Thanks Frank for the response. +1 for having a call. Could you please
propose few time slots?

On Sun, Nov 22, 2015 at 6:55 PM, Frank Leymann  wrote:

> Dear Thamali,
>
> we (APIM, ES Publisher,... teams) developed some guidelines on making all
> of our APIs more consistent. For example, versioning (major, minor, patch)
> as part of the URL context etc.  Also, you are not using PUT but always
> POST - this has some implications a bunch of REST-folks are serious about.
> Similarly, the use of proper HTTP headers is a REST issue to reduce the
> amount of data transferred, to avoid potential concurrency problems etc.
>
> Should we have a call to discuss the API and check where we can help?
>
>
>
> Best regards,
> Frank
>
> 2015-11-18 12:10 GMT+01:00 Nirmal Fernando :
>
>> Thanks Thamali! Please try to generate the Swagger definition for ML API
>> as the next step.
>>
>> On Wed, Nov 18, 2015 at 12:21 PM, Thamali Wijewardhana 
>> wrote:
>>
>>> REST API standards define the way to produce a RESTful API. For an API
>>> to become a RESTful API, it should confirm to those REST  standards.This
>>> document includes a set of  improvements to make the WSO2 API, a RESTful
>>> API.
>>>
>>>
>>>
>>> https://docs.google.com/spreadsheets/d/1HYiS-TpqYaZTtBLLSIeYZ_nvZkbt7zAFwetnHLe4vg8/edit#gid=0
>>>
>>>
>>>
>>
>>
>> --
>>
>> Thanks & regards,
>> Nirmal
>>
>> Team Lead - WSO2 Machine Learner
>> Associate Technical Lead - Data Technologies Team, WSO2 Inc.
>> Mobile: +94715779733
>> Blog: http://nirmalfdo.blogspot.com/
>>
>>
>>
>


-- 

Thanks & regards,
Nirmal

Team Lead - WSO2 Machine Learner
Associate Technical Lead - Data Technologies Team, WSO2 Inc.
Mobile: +94715779733
Blog: http://nirmalfdo.blogspot.com/
___
Dev mailing list
Dev@wso2.org
http://wso2.org/cgi-bin/mailman/listinfo/dev

Re: [Dev] Cleaning up ML REST API

[Sanjeewa Malalgoda]

Hi nirmal,
please invite apim rest api team as well. we would like to join this
discussion.

Thanks
sanjeewa.

sent from my phone
On Nov 22, 2015 7:00 PM, "Nirmal Fernando"  wrote:

> Thanks Frank for the response. +1 for having a call. Could you please
> propose few time slots?
>
> On Sun, Nov 22, 2015 at 6:55 PM, Frank Leymann  wrote:
>
>> Dear Thamali,
>>
>> we (APIM, ES Publisher,... teams) developed some guidelines on making all
>> of our APIs more consistent. For example, versioning (major, minor, patch)
>> as part of the URL context etc.  Also, you are not using PUT but always
>> POST - this has some implications a bunch of REST-folks are serious about.
>> Similarly, the use of proper HTTP headers is a REST issue to reduce the
>> amount of data transferred, to avoid potential concurrency problems etc.
>>
>> Should we have a call to discuss the API and check where we can help?
>>
>>
>>
>> Best regards,
>> Frank
>>
>> 2015-11-18 12:10 GMT+01:00 Nirmal Fernando :
>>
>>> Thanks Thamali! Please try to generate the Swagger definition for ML API
>>> as the next step.
>>>
>>> On Wed, Nov 18, 2015 at 12:21 PM, Thamali Wijewardhana >> > wrote:
>>>
 REST API standards define the way to produce a RESTful API. For an API
 to become a RESTful API, it should confirm to those REST  standards.This
 document includes a set of  improvements to make the WSO2 API, a RESTful
 API.



 https://docs.google.com/spreadsheets/d/1HYiS-TpqYaZTtBLLSIeYZ_nvZkbt7zAFwetnHLe4vg8/edit#gid=0



>>>
>>>
>>> --
>>>
>>> Thanks & regards,
>>> Nirmal
>>>
>>> Team Lead - WSO2 Machine Learner
>>> Associate Technical Lead - Data Technologies Team, WSO2 Inc.
>>> Mobile: +94715779733
>>> Blog: http://nirmalfdo.blogspot.com/
>>>
>>>
>>>
>>
>
>
> --
>
> Thanks & regards,
> Nirmal
>
> Team Lead - WSO2 Machine Learner
> Associate Technical Lead - Data Technologies Team, WSO2 Inc.
> Mobile: +94715779733
> Blog: http://nirmalfdo.blogspot.com/
>
>
>
___
Dev mailing list
Dev@wso2.org
http://wso2.org/cgi-bin/mailman/listinfo/dev

Re: [Dev] Cleaning up ML REST API

[Nirmal Fernando]

Thanks Thamali! Please try to generate the Swagger definition for ML API as
the next step.

On Wed, Nov 18, 2015 at 12:21 PM, Thamali Wijewardhana 
wrote:

> REST API standards define the way to produce a RESTful API. For an API to
> become a RESTful API, it should confirm to those REST  standards.This
> document includes a set of  improvements to make the WSO2 API, a RESTful
> API.
>
>
>
> https://docs.google.com/spreadsheets/d/1HYiS-TpqYaZTtBLLSIeYZ_nvZkbt7zAFwetnHLe4vg8/edit#gid=0
>
>
>


-- 

Thanks & regards,
Nirmal

Team Lead - WSO2 Machine Learner
Associate Technical Lead - Data Technologies Team, WSO2 Inc.
Mobile: +94715779733
Blog: http://nirmalfdo.blogspot.com/
___
Dev mailing list
Dev@wso2.org
http://wso2.org/cgi-bin/mailman/listinfo/dev