Undisturbed REST: a Guide to Designing the Perfect API - Softcover

Stowe, Michael

Softcover

ISBN 10: 1329115945 ISBN 13: 9781329115941

Publisher: Lulu.com, 2015

Synopsis

Believe it or not, building an API is the easy part. What is far more challenging is to put together an API design that will stand the test of time, while also meeting your developers' needs. After all, no matter how well written your code may be, without a strong foundation, you will find your API quickly failing.

Undisturbed REST works to tackle this issue through the use of modern design techniques and technology, showing how to carefully design your API with your users and longevity in-mind, taking advantage of a design-first approach- while incorporating best practices and hard lessons learned. After reading Undisturbed REST, you'll have a strong understanding of APIs, best practices, and available tooling for designing, prototyping, sharing, documenting, and generating tooling (such as SDKs) around your API.

More importantly, you'll be equipped to design and build an API not just for today, but one that can stand the test of time and lead your application into tomorrow.

Chapter Breakdown:

1. What is an API
2. Planning Your API
3. Designing the Spec
4. Using RAML
5. Prototyping and Agile Testing
6. Authorization and Authentication
7. Designing Your Resources
8. Designing Your Methods
9. Handling Responses
10. Adding Hypermedia
11. Managing with a Proxy
12. Documenting and Sharing Your API
13. A Final Thought

About this title

About the Author

Michael Stowe is a professional software engineer with over 10 years experience in building applications for law enforcement, the medical field, nonprofits, and numerous industrial companies.  Over the last two years he has been focused on API design and ways to improve industry standards, speaking at conferences including API World, API Strategy & Design, API Days, and numerous others while also being a leading voice for RAML and Spec Driven Development.

From the Back Cover

Design Great APIs

APIs are fundamentally changing the way that companies are doing business, creating unprecedented opportunities for innovation and providing new ways to engage with your customers, partners, and employees.

Undisturbed REST digs into the questions that one must answer to be successful is building and designing their API, while also covering modern design techniques and explaining more complex concepts as REST and hypermedia as the engine of application state (HATEOAS).

By following the carefully laid out approaches and taking advantage of the best practices shared in this book, you'll be armed with the knowledge to build an API your customers will love, as well as one that can be easily integrated and extended.

Edition details

• Publisher: Lulu.com
• Publication date: 2015
• Language: English
• ISBN 10: 1329115945
• ISBN 13: 9781329115941
• Binding: Paperback
• Edition number: 1
• Number of pages: 200