A preview of the new Dropbox API v2(blogs.dropbox.com) |
A preview of the new Dropbox API v2(blogs.dropbox.com) |
Why? Why would you use a POST call for the first endpoint they demonstrate, users/get_current_account
curl -X POST https://api.dropbox.com/2-beta/users/get_current_account \
--header "Authorization: Bearer <access-token>" \
--header "Content-Type: application/json" \
--data "null"
Why not implement that as a GET-call?Arguably, HTTP-based RPC with consistent use of POST is a lot more straightforward of a model than the kinda-sorta-REST-without-HATEOAS that a lot of APIs use, and arguably for APIs whose scope is a particular server and not the kind of generality that the web as a whole itself (the archetypical REST service) provides, POST-based HTTP-RPC is a more natural choice than REST.
The RPC-style endpoints all use POST and are not cacheable.