The Design of Web APIs is a practical, example-packed guide to crafting extraordinary web APIs. Author Arnaud Lauret demonstrates fantastic design principles and techniques you can apply to both public and private web APIs.
Foreword by Kin Lane, The API Evangelist.
About the Technology
An API frees developers to integrate with an application without knowing its code-level details. Whether you're using established standards like REST and OpenAPI or more recent approaches like GraphQL or gRPC, mastering API design is a superskill. It will make your web-facing services easier to consume and your clients—internal and external—happier.
About the Book
Drawing on author Arnaud Lauret's many years of API design experience, this book teaches you how to gather requirements, how to balance business and technical goals, and how to adopt a consumer-first mindset. It teaches effective practices using numerous interesting examples.
What's inside
• Characteristics of a well-designed API
• User-oriented and real-world APIs
• Secure APIs by design
• Evolving, documenting, and reviewing API designs
About the Reader
Written for developers with minimal experience building and consuming APIs.
About the Author
A software architect with extensive experience in the banking industry, Arnaud Lauret has spent 10 years using, designing, and building APIs. He blogs under the name of API Handyman and has created the API Stylebook website.
Author(s): Arnaud Lauret
Edition: 1
Publisher: Manning Publications
Year: 2019
Language: English
Commentary: True PDF
Pages: 392
City: Shelter Island, NY
Tags: Web Applications; API Design; RESTful API; Security; Documentation
PART 1 - Fundamentals of API design
1. What is API design?
2. Designing an API for its users
3. Designing a programming interface
4. Describing an API with an API description format
PART 2 - Usable API design
5. Designing a straightforward API
6. Designing a predictable API
7. Designing a concise and well-organized API
PART 3 - Contextual API design
8. Designing a secure API
9. Evolving an API design
10. Designing a network?efficient API
11. Designing an API in context
12. Documenting an API
13. Growing APIs