/dev/reading

Designing APIs with Swagger and OpenAPI

by Joshua S. Ponelat and Lukas L. Rosenstock
The cover of Designing APIs with Swagger and OpenAPI
4.33/5 on Goodreads
ISBN 9781617296284
Published in 2022
424 pages

Description

Follow real-world API projects from concept to production, and learn hands-on how to describe and design APIs using OpenAPI.

In Designing APIs with Swagger and OpenAPI you will learn how to:

  • Understand OpenAPI syntax and structure
  • Use Swagger and other tooling to create OpenAPI definitions
  • Design authentication and authorization
  • Turn an OpenAPI description into online documentation
  • Automate processes and generating code
  • Iterate an API design with user stories
  • Build a frontend against a mock server
  • Generate backend code with Swagger Codegen
  • Versioning an API and dodging breaking changes
  • Work with cross-functional teams

Designing APIs with Swagger and OpenAPI is a comprehensive guide to designing and describing your first RESTful API using the most widely adopted standards. Following expert instruction from Swagger core contributor Josh Ponelat and API consultant Lukas Rosenstock, you’ll spend each chapter progressively expanding the kind of APIs you’ll want to build in the real world. You’ll utilize OpenAPI and Swagger to help automate your workflow, and free up your time to work on more exciting features. Learn the syntax and structure of OpenAPI definitions, create and iterate on an API design with common tools, and release your API to the public.