any reason for not using something like OData (with HTTP/JSON) for the REST API? about staash

[sblom]

OData's greatest strength is that it enables fairly rich ad hoc queries over your entire dataset. OData's greatest weakness is that it enables fairly rich ad hoc queries over your entire dataset. For internal applications, OData is usually quite quick to set up and there are some useful tools for doing ad hoc exploration of the dataset.

For public applications, I would caution against shipping an OData endpoint. From personal experience, the right way to think about an OData endpoint is as a SQL connection string over HTTP. Once you ship an OData endpoint, your users will be free to query/filter/sort over your data in any way that they choose from now until the end of time. If you ever discover that particular use cases would benefit from optimization, good luck because you'll have to write code to spot specific query patterns and route them to a different processor than the generic OData one.

[shyamalan]

Odata seems to be more focussed on navigating connected entities and is oriented towards being meta-data driven , from the general use-case point of view it would seem like a bit of an overhead for some of the scenarios we had in mind, though it does provide a higher level abstraction and is a great fit for certain situations, eventually the application will be coupled with odata service via the metadata and links in the responses. Thanks for the pointers , I will take a look at those in more detail.

[approachings]

some years later, as OData and the internet have changed; I'd say the above mentioned reasons no longer apply

if you need an optimization endpoint, you can just make an new entity type for browsing the optimized results

as far as publishing, you can have pretty good security going on with OAuth now so if you really need, just have expiring authentication tokens and access tokens

OData is a good API as long as your API is geared toward sharing data. if the main focus is triggering actions through web services, OData is not well suited for that. for example transactional, multi-step APIs in which you generate/send/create entities the API will operate on

for example mass geocoding could be done through OData but it would not be very natural to shoehorn bulk data input in