Book
The Design of Web APIs
The Design of Web APIs
Arnaud Lauret
Summary
OpenAPIを用いたスキーマファースト開発、ページネーション、バージョニングなど、 実稼働するAPIの運用を見据えた実践的設計手法を解説。
Target Readers
- API設計を体系的に学びたい中級エンジニア
- OpenAPI仕様を活用したい開発チーム
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
Prerequisites
- Recommended
Web API: The Good Parts
水野貴明
Reason: Once you've grasped the basics of REST design, you advance to describing and sharing an API as a 'contract.' The Design of Web APIs presents a spec-driven design process with OpenAPI, giving you a repeatable way to build consistent APIs across a team.
- Related
Webを支える技術
山本陽平
Reason: With the Web's foundations understood, you advance to viewing API creation as a systematic design process. The Design of Web APIs connects user-centered API design with description via OpenAPI, showing how to design APIs as a methodology rather than by improvisation.
Next Books
- Recommended
セキュアAPI
José Haro Peralta
Reason: Having grasped the practice of API design—contract-first with OpenAPI, pagination, versioning—you start to see the next challenge: how to build security into that design. Secure APIs builds up a shift-left perspective, addressing authentication/authorization vulnerabilities and API configuration risks starting from the design stage.
Sources
- 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
- Related
gRPCアップアンドランニング
gRPC: Up and Running
Kasun Indrasiri、Danesh Kuruppu
Reason: Comfortable with contract design via OpenAPI, you move to gRPC, which uses Protocol Buffers as a stricter, binary-efficient contract. Comparing the experience of generating types and stubs from a schema reveals the breadth of contract-driven development.
- Related
Web APIテスト技法
Testing Web APIs
Mark Winteringham
Reason: Once you can design an API, you need a way to verify that the design keeps working as promised. Testing Web APIs introduces contract testing, letting you catch mismatches between provider and consumer in CI.