[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Workgroup 3 update
Here’s a status update following our meeting today. We worked mostly on a generic query endpoint, trying to leave it as open-ended as possible without having to specify an actual query language. However, an argument could be made that this endpoint doesn’t bring any value to the standard since it is not specified (i.e. the actual query and results would have implementation-specific formats) and would presumably be optional. We therefore raise the question of whether such an endpoint should be included in the standard at all.
Another issue was whether to use POST or GET methods for queries in the endpoint. We settled on using POST which, after consideration make sense (if your resource is “queries” then, POST with data allows you to “create” a query).
Here are some links on the issue:
https://evertpot.com/dropbox-post-api/ (this one mentions the REPORT method which I wasn’t aware of)
Roy Fielding’s point of view on the question (via SO): http://stackoverflow.com/a/983458
More generally speaking, here’s a useful resource for pragmatic RESTful API design:
The git repository has been updated.
Chris (for workgroup 3)