Hacker News Reader

Hacker News

Comment by huherto | Hacker News Reader

Full thread

huherto

Follow up. Anyone care to recommend a good book or reference on good design of REST APIs?

View on HN

I collated a list of best practices here:

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

I read this after patio11 linked to it. It's an amazing resource, thank you!

Well done. I opened your link, expecting more banal hand waving dogma. Instead, I found myself nodding agreement with most items in your list. Thank you.

+1 for Vinay's post on API design. I came across it a few months ago and it was a brilliant checklist/guide for us developing an API for our web app.

Thank you for posting this. Awesome!

REST in Practice[1], Building Hypermedia APIs with HTML5 and Node[2] and Designing Hypermedia APIs[3].

1. https://www.amazon.com/REST-Practice-Hypermedia-Systems-Arch...

2. https://www.amazon.com/Building-Hypermedia-APIs-HTML5-Node/d...

3. http://www.designinghypermediaapis.com/

+1, if you have to do REST, this is the book.

Our book study group covered this book a few years ago. This book is rational, its advice actionable.

Like "Agile", "REST" is merely a pretext to start an argument. Just do what works, focusing on reducing the cost of change (risk mitigation).

Which one? There are three listed.

My bad. #1. I blindly assumed links were all to same book.

My employer (Apigee) makes a good introductory ebook on this topic. Be forewarned this is a huge topic with many (strong) opinions on what 'good' REST actually is.

http://apigee.com/about/resources/ebooks/web-api-design

I can vouch for this. It really helped me when I was getting started with REST APIs.

My coworker just bought this and loves it. https://leanpub.com/build-apis-you-wont-hate

The examples are PHP-based and there is an active Slack channel supporting the book.

Make sure to read the Fielding Dissertation to understand what REST actually is.

https://news.ycombinator.com/item?id=9737403

Reply on news.ycombinator.com