News for hackers. Stuff that matters.
Re:Show HN: A Browse-able RESTish API by nbpoole on Sunday February 20, 2011 @01:04PM (#2242516)
To quote the blog post:

"The reason for not supporting the DELETE/PUT methods is quite simple: by reducing the possible interactions to what a standard browser performs (GET/POST) we allow developers to interact with our api through their web browser."

The same line of thinking applies to OPTIONS as well. Ideally, the API could support both types of usage, but that wasn't what they were trying to accomplish.

Re:Show HN: A Browse-able RESTish API by hammerdr on Sunday February 20, 2011 @01:32PM (#2242612)
I'm more questioning why they thought that was a good idea when there are some drawbacks to overloading GET and some known ways[1] to work around browser limitations of PUT/DELETE/OPTIONS on forms.

For example, as a consumer of the API I would expect GET /clients to return a list of clients and not a OPTIONS-like response of possible paths.

I'm definitely playing the purist here which is not my typical role. The OPTIONS solution is not a well known one but it is something that I'd like to be picked up.

[1] http://guides.rubyonrails.org/form_helpers.html#how-do-forms...

Re:Show HN: A Browse-able RESTish API by qixxiq on Sunday February 20, 2011 @01:42PM (#2242635)
The main reason at the end of the day is to land up with an API that is:

a. Fully browse-able with standard web browsers.

b. Acts in the exact same way with a browser as it does with any other client.

The api design functions on the simple idea of having a "GET" request act as a discovery mechanism while "POST" requests perform operations and searches -- much like how most websites function.

I understand you might expect the client listing at GET /clients, but I believe within a few minutes of looking at our design most people can work out its rather a POST /clients/list. You'll be looking at the documentation for almost any api you use, so I didn't really find that to be a major factor.

Re:Show HN: A Browse-able RESTish API by jsarch on Sunday February 20, 2011 @02:13PM (#2242701)
FWIW, this comment:

"The api design functions on the simple idea of having a "GET" request act as a discovery mechanism while "POST" requests perform operations and searches -- much like how most websites function."

should make its way into your blog post or final documentation. I was thoroughly confused because there's no mention that GET and POST are actually different in the blog post. Best of luck with the API creation.