Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

Yes. As a hacker who leans on books, blogs, and well-defined principles, RESTful api design resources have often been much more http RPC oriented.

Hackers should pay attention to:

http://roy.gbiv.com/untangled/2008/rest-apis-must-be-hyperte...

I have also found collection+json and hypermedia application language (HAL) to be useful.

Plus, I have spent a bunch of time reading the Restful Web APIs book from O'Reilly. Useful for me, as a relative newbie, in providing some logical foundation to start from . . .



http://roy.gbiv...

Money quote:

REST is intended for long-lived network-based applications that span multiple organizations. If you don’t see a need for the constraints, then don’t use them. That’s fine with me as long as you don’t call the result a REST API.


Do you have an example of an API that meet's Fielding's definition of REST?


tl;dr: Not that I've dug into.

I've found a number of people who point at the Github api as a good example of a RESTful api that includes hypermedia links for clients to follow rather than constructing URI requests manually. It looks good to me.




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: