Sorry, I don't follow. Is there something in that stack overflow post that you think is relevant in particular, or are you just calling attention to REST API versioning generally?
On Thu, Aug 26, 2010 at 10:45 AM, David Winslow <[email protected]>wrote: > See also: > http://stackoverflow.com/questions/389169/best-practices-for-api-versioning > > > On Thu, Aug 26, 2010 at 10:40 AM, Sebastian Benthall <[email protected]>wrote: > >> I'm +1 axing the full json dump for maps >> >> >> On Thu, Aug 26, 2010 at 10:37 AM, David Winslow <[email protected]>wrote: >> >>> Is this a useful distinction? It seems like having a filterable listing >>> is better than having a listing and a search, api-wise. In fact, we should >>> probably enforce a maximum page size on the listing query either way. >>> >>> -d >>> >>> On Thu, Aug 26, 2010 at 10:31 AM, Sebastian Benthall >>> <[email protected]>wrote: >>> >>>> The difference between /maps and /maps/search/api currently is that >>>> /maps is a straight json dump of all the map configurations, and >>>> /maps/search/api provides extra information about the search in its results >>>> and accepts query parameters that are useful especially if you are trying >>>> to >>>> populate a paging Extjs table with the results. >>>> >>>> >>>> On Thu, Aug 26, 2010 at 10:27 AM, David Winslow >>>> <[email protected]>wrote: >>>> >>>>> What is the distinction between an API and a Search API? >>>>> >>>>> -d >>>>> >>>>> >>>>> On Thu, Aug 26, 2010 at 10:22 AM, Sebastian Benthall >>>>> <[email protected]>wrote: >>>>> >>>>>> *Proposal for 1.0:* >>>>>> >>>>>> /data >>>>>> /data/search >>>>>> /data/search/api >>>>>> >>>>>> /maps *<-- the only proposed change*(s) >>>>>> /maps/api *<-- the only proposed change*(s) >>>>>> /maps/search >>>>>> /maps/search/api >>>>>> >>>>>> >>>>>> *Alternative proposal for 1.0:* >>>>>> Same as a above but dropping maps/api entirely. >>>>>> >>>>>> >>>>>> *Speculative proposal for future release:* >>>>>> >>>>>> /search >>>>>> /search/api >>>>>> >>>>>> /data >>>>>> /data/api --> ??? >>>>>> /data/search --> redirects to /search?flag=data >>>>>> /data/search/api --> redirects to /search/api?flag=data >>>>>> >>>>>> /maps >>>>>> /maps/api --> full json dump >>>>>> /maps/search --> redirects to /search?flag=maps >>>>>> /maps/search/api --> redirects to /search/api?flag=maps >>>>>> >>>>>> >>>>>> >>>>>> On Thu, Aug 26, 2010 at 10:04 AM, David Winslow <[email protected] >>>>>> > wrote: >>>>>> >>>>>>> It would be nice to flesh this out a bit to avoid shifting URLs >>>>>>> around after the 1.0 release if we can help it. >>>>>>> >>>>>>> -d >>>>>>> >>>>>>> >>>>>>> On Thu, Aug 26, 2010 at 9:53 AM, Sebastian Benthall <[email protected] >>>>>>> > wrote: >>>>>>> >>>>>>>> Currently combined maps and data search is unspecified except for >>>>>>>> "it would be nice to combine maps and data search some day." >>>>>>>> >>>>>>>> So I suppose this doesn't interact with those plans at all. >>>>>>>> >>>>>>>> >>>>>>>> On Thu, Aug 26, 2010 at 8:59 AM, David Winslow < >>>>>>>> [email protected]> wrote: >>>>>>>> >>>>>>>>> How does this interact with plans to unify map search with data >>>>>>>>> search? >>>>>>>>> >>>>>>>>> -d >>>>>>>>> >>>>>>>>> >>>>>>>>> On Wed, Aug 25, 2010 at 9:49 PM, Ariel Nunez < >>>>>>>>> [email protected]> wrote: >>>>>>>>> >>>>>>>>>> > I propose we change the url structure in these ways: >>>>>>>>>> > /maps - overview page of GeoNode's map-related tools >>>>>>>>>> (was /community ) >>>>>>>>>> > /maps/api - a json dump of all map configurations >>>>>>>>>> >>>>>>>>>> +1 >>>>>>>>>> >>>>>>>>>> I thought about this issue too a couple of weeks ago, and agree >>>>>>>>>> with >>>>>>>>>> your proposal. >>>>>>>>>> >>>>>>>>>> Ariel >>>>>>>>>> >>>>>>>>> >>>>>>>>> >>>>>>>> >>>>>>>> >>>>>>>> -- >>>>>>>> Sebastian Benthall >>>>>>>> OpenGeo - http://opengeo.org >>>>>>>> >>>>>>>> >>>>>>> >>>>>> >>>>>> >>>>>> -- >>>>>> Sebastian Benthall >>>>>> OpenGeo - http://opengeo.org >>>>>> >>>>>> >>>>> >>>> >>>> >>>> -- >>>> Sebastian Benthall >>>> OpenGeo - http://opengeo.org >>>> >>>> >>> >> >> >> -- >> Sebastian Benthall >> OpenGeo - http://opengeo.org >> >> > -- Sebastian Benthall OpenGeo - http://opengeo.org
