[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Web Services API: URL naming proposal



On Fri, Nov 18, 2011 at 7:10 AM, Håvard Sørli <..hidden..> wrote:
> On 18. nov. 2011 14:52, Chris Travers wrote:
>> Figure i will wade in here.  Hopefully others will follow.
>> On Sun, Nov 13, 2011 at 10:45 AM, Erik Huelsmann<..hidden..>  wrote:
>
>> i don;t think that would be a problem. I don't like store though
>> because it is pretty unclear.  I would suggest a base path of:
>>
>> http://myhost/ledgersmb/webservices/company_name/
>
> I assume this will also work:
>  > http://myhost/webservices/company_name/

Depending on the web server config, that is possible.

>
> Could we make it shorter:
> http://myhost/ledgersmb/api/company_name/
> http://myhost/api/company_name/

That is worth discussing.  What do other people think?

If we want it short, what about
 http://myhost/ledgersmb/ws/company_name/
>
> It there are only one company, could we use only
> http://myhost/ledgersmb/api/
> http://myhost/api

I think that would be asking for trouble.  I think we are going to get
more mileage and have fewer bugs if the API is consistent and
reliable.  Omitting pieces in the middle strikes me as asking for
trouble later.

Best Wishes,
Chris Travers