Re: [Dev] Cleaning up ML REST API
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 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 improv
Re: [Dev] Cleaning up ML REST API
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. > > > > https://docs.google.com/spreadsheets/d/1HYiS-TpqYaZTtBLLSIeYZ_nvZkbt7zAFwetnHLe4vg8/edit#gid=0 > > > -- >
Re: [Dev] Cleaning up ML REST API
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/ >>> >>> >>> >> > > > -- > > Thanks & regards, > Nirmal > > Team Lead - WSO2 Machine Learner > Associate Technical Le
Re: [Dev] Cleaning up ML REST API
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 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
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 >> >> Team Lead - WSO2 Machine Learner >> Associate Technical Lead - Data Technologies Team, WSO2 Inc. >> Mobile: +94715779733 >> Blog: http:/
Re: [Dev] Cleaning up ML REST API
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
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
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
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
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
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
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