Book
The Design of Web APIs
The Design of Web APIs
Arnaud Lauret
Summary
Arnaud Lauret, who blogs as the API Handyman after ten years designing APIs in banking, argues that API design is a distinct skill separate from whichever technology builds the API, whether REST, GraphQL, or gRPC. The book starts from gathering requirements and adopting a consumer-first mindset, then works through programming interface design, OpenAPI description formats, simplicity, predictability, and security, before turning to versioning, pagination, and documentation for APIs already in production. Its many small, concrete examples focus on the design decisions consumers actually feel, not the protocol underneath them.
Target Readers
- Backend developers who can implement REST endpoints but haven't yet reasoned explicitly about consumer-first API design
- Teams adopting OpenAPI as a schema-first workflow who want the design principles behind the specification, not just its syntax
- API designers responsible for versioning and evolving a production API without breaking existing consumers
Tags
Colophon
- Publisher
- 翔泳社
- ISBN
- 978-4798167015
- Published
- Aug 2020
- List price
- ¥4,180incl. taxMay differ from the actual selling price on Amazon
Get this book
* The link above is an advertisement via Amazon Associates.Related Books
Next Books
- Related
Learning GraphQL
Learning GraphQL
Eve Porcello、Alex Banks
Reason: Having experienced design-driven REST described with OpenAPI, you compare GraphQL, which realizes the same 'schema-first' idea in a different shape. The shared emphasis on designing APIs around a typed schema—and the difference in query models—deepens your understanding.
Sources