Show HN: Restless to RESTful - are we doing it right?

6 points by faxman 14y ago ↗ HN

Following on our previous discussion on HN [1], we've gone ahead and implemented a REST interface for our online fax service, where we previously only had a SOAP API.

Documentation [2] is 90% complete, so this might be a good time to get your feedback if we're doing it right.

As always, brutal honesty appreciated!

--------------

[1] http://news.ycombinator.com/item?id=3467287

[2] http://www.interfax.net/en/dev/rest/reference

2 comments

[ 1.6 ms ] story [ 12.8 ms ] thread

ColinWright 14y ago ↗

Clickables:

[1] http://news.ycombinator.com/item?id=3467287

[2] http://www.interfax.net/en/dev/rest/reference

gabrtv 14y ago ↗

Where are the PUTs? POST /inbound/faxes/{id}/mark - Mark as read/unread

Shouldn't that be a PUT on /inbound/faxes/{id}? Seems like you're updating the representation of the fax, not performing some non-idempotent action (like a resend, which can easily justify a POST).

In general though, I think the API looks good. I'm sure it's much better than the SOAP equivalent!