4 ms·
Ask HN: how to build a good RESTful JSON API (best practices, etc.)?
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
- a3n 13y agoI'm not an expert. Here's a few resources I've collected: http://www.restapitutorial.com/ http://www.restapitutorial.com/ http://www.restapitutorial.com/media/RESTful_Best_Practices-v1_1.pdf http://www.restapitutorial.com/media/RESTful_Best_Practices-... REST API Design Rulebook: http://shop.oreilly.com/product/0636920021575.do http://shop.oreilly.com/product/0636920021575.do RESTful Web Services: http://shop.oreilly.com/product/9780596529260.do http://shop.oreilly.com/product/9780596529260.do http://restcookbook.com/ http://restcookbook.com/ https://en.wikipedia.org/wiki/Representational_state_transfer https://en.wikipedia.org/wiki/Representational_state_transfe...
- tunnuz 13y agoGreat, this is absolutely what I needed. Especially http://www.restapitutorial.com/media/RESTful_Best_Practices-v1_1.pdf http://www.restapitutorial.com/media/RESTful_Best_Practices-...
- samufuentes 13y agoYou can check some docu from apigee as well: http://info.apigee.com/Portals/62317/docs/web%20api.pdf http://info.apigee.com/Portals/62317/docs/web%20api.pdf
- johns 13y agohttp://john-sheehan.com/post/18688963163/dont-build-the-best-rest-api-build-the-best-http-api http://john-sheehan.com/post/18688963163/dont-build-the-best...
- theGREENsuit 13y ago[url]http://www.vinaysahni.com/best-practices-for-a-pragmatic-restful-api[/url] http://www.vinaysahni.com/best-practices-for-a-pragmatic-res...
- veesahni 13y agoworking link: http://www.vinaysahni.com/best-practices-for-a-pragmatic-restful-api http://www.vinaysahni.com/best-practices-for-a-pragmatic-res...
- andrewhillman 13y agoapigee dot com has a ton of white papers on this subject. well crafted too.
- nreece 13y agoCheckout 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 http://lcsd05.cs.tamu.edu/slides/keynote.pdf