There's nothing to follow, it is just a link with some relevant advice. -d
On Thu, Aug 26, 2010 at 11:07 AM, Sebastian Benthall <[email protected]>wrote: > 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 > >
