6 ms·

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

• akman 10y ago
  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 http://apigee.com/about/resources/ebooks/web-api-design
  • amjd 10y ago
    I can vouch for this. It really helped me when I was getting started with REST APIs.
• ethagnawl 10y ago
  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-Architecture/dp/0596805829/ref=sr_1_1?ie=UTF8&qid=1466797753&sr=8-1&keywords=rest+in+practice https://www.amazon.com/REST-Practice-Hypermedia-Systems-Arch... 2. https://www.amazon.com/Building-Hypermedia-APIs-HTML5-Node/dp/1449306578/ref=sr_1_1?ie=UTF8&qid=1466797771&sr=8-1&keywords=hypermedia+api+node+html5 https://www.amazon.com/Building-Hypermedia-APIs-HTML5-Node/d... 3. http://www.designinghypermediaapis.com/ http://www.designinghypermediaapis.com/
  • specialist 10y ago
    +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).
    • rimantas 10y ago
      Which one? There are three listed.
      • specialist 10y ago
        My bad. #1. I blindly assumed links were all to same book.
• mmccaff 10y ago
  My coworker just bought this and loves it. https://leanpub.com/build-apis-you-wont-hate https://leanpub.com/build-apis-you-wont-hate The examples are PHP-based and there is an active Slack channel supporting the book.
• veesahni 10y ago
  I collated a list of best practices here: http://www.vinaysahni.com/best-practices-for-a-pragmatic-restful-api http://www.vinaysahni.com/best-practices-for-a-pragmatic-res...
  • mcobrien 10y ago
    I read this after patio11 linked to it. It's an amazing resource, thank you!
  • specialist 10y ago
    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.
  • cyberferret 10y ago
    +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.
  • josh_carterPDX 10y ago
    Thank you for posting this. Awesome!
• phamilton 10y ago
  Make sure to read the Fielding Dissertation to understand what REST actually is.
• arsey 10y ago
  https://news.ycombinator.com/item?id=9737403 https://news.ycombinator.com/item?id=9737403