Ask HN: how to build a good RESTful JSON API (best practices, etc.)?

10 points·tunnuz··8 comments

Hi everyone, I am completely new to making RESTful JSON APIs, and I would like to know more about the best practices before starting. Do you have any piece of advice / good tutorials to look at?

Thanks

View on HN

I'm not an expert. Here's a few resources I've collected:

http://www.restapitutorial.com/

http://www.restapitutorial.com/media/RESTful_Best_Practices-...

REST API Design Rulebook: http://shop.oreilly.com/product/0636920021575.do

RESTful Web Services: http://shop.oreilly.com/product/9780596529260.do

http://restcookbook.com/

https://en.wikipedia.org/wiki/Representational_state_transfe...

Great, this is absolutely what I needed. Especially http://www.restapitutorial.com/media/RESTful_Best_Practices-...

Checkout the presentation 'How to Design a Good API and Why it Matters' by Joshua Bloch (Principal Software Engineer at Google): http://lcsd05.cs.tamu.edu/slides/keynote.pdf

You can check some docu from apigee as well: http://info.apigee.com/Portals/62317/docs/web%20api.pdf

http://john-sheehan.com/post/18688963163/dont-build-the-best...

[url]http://www.vinaysahni.com/best-practices-for-a-pragmatic-res...

working link: http://www.vinaysahni.com/best-practices-for-a-pragmatic-res...

apigee dot com has a ton of white papers on this subject. well crafted too.

Reply on news.ycombinator.com