Thursday, March 22, 2012

Another free ebook from the team at Apigee - "Web API Design: Crafting Interfaces that Developers Love"

Apigee - API Best Practices Blog - Announcement: Free eBook on Web API Design

We wrote an API design book! In 2009, a couple of my fellow Apigeeks (@earth2marsh & @gbrail) and I were frustrated with how many bad, inconsistent Web APIs we encountered in the world. So, we started cataloging the bad (and good) things we saw people doing to other people through API design. After three years of discussions, presentations and implementations with technologists all over the world (online & in real life), we are happy to announce the beta version of a new eBook.

Web API Design: Crafting Interfaces that Developers Love

Although I did my best to chase down errors, there are likely mistakes and bugs in the book. Plus, it's shocking how poorly code and eBook publishing get along. Despite some blemishes though I think you'll enjoy kicking back and reading some of the world's best thinking about API design.

..."

imageimage

"Introduction
If you’re reading this, chances are that you care about designing Web APIs that developers will love and that you’re interested in applying proven design principles and best practices to your Web API.
One of the sources for our design thinking is REST. Because REST is an architectural style and not a strict standard, it allows for a lot of flexibly. Because of that flexibility and freedom of structure, there is also a big appetite for design best practices.

This e-book is a collection of design practices that we have developed in collaboration with some of the leading API teams around the world, as they craft their API strategy through a design workshop that we provide at Apigee.

We call our point of view in API design “pragmatic REST”, because it places the success of the developer over and above any other design principle. The developer is the customer for the Web API. The success of an API design is measured by how quickly developers can get up to speed and start enjoying success using your API.

..."

Looks like another great resource. Sent to my Kindle... :)

 

Related Past Post XRef:
O what is OAuth? "OAuth: The Big Picture" Free eBook (PDF/Mobi/ePub)

1 comment:

Maarten De Muynck said...

Best book for developers I've read so far. Simple and to the point and not again 500 pages! Great work.