Designing APIs with Swagger and OpenAPI you own this product

Joshua S. Ponelat and Lukas L. Rosenstock
  • May 2022
  • ISBN 9781617296284
  • 424 pages
  • printed in black & white
  • Available translations: Korean

pro $24.99 per month

  • access to all Manning books, MEAPs, liveVideos, liveProjects, and audiobooks!
  • choose one free eBook per month to keep
  • exclusive 50% discount on all purchases

lite $19.99 per month

  • access to all Manning books, including MEAPs!

team

5, 10 or 20 seats+ for your team - learn more


Look inside
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.

about the technology

Create web APIs that customers and developers will love! Using Swagger, a collection of tools for defining and documenting REST APIs, you will build safe, controlled access to your software. And because Swagger implements the vendor-neutral OpenAPI specification, you’ll be building to the same standards adopted by Google, Microsoft, and Amazon.

about the book

Designing APIs with Swagger and OpenAPI introduces a design-first approach. Written for developers new to API design, it follows the lifecycle of an API project from concept to production. You’ll explore the dos and don’ts of APIs through progressively complete examples. You’ll get hands-on experience designing APIs for specific business needs, using open source tools to generate documentation, and building developer-friendly components like mocks and client SDKs.

what's inside

  • OpenAPI syntax and structure
  • Using Swagger to create OpenAPI definitions
  • Automating processes and generating code
  • Working with cross-functional teams

about the reader

For web developers. No prior knowledge of Swagger or OpenAPI required.

about the authors

Josh Ponelat is the Swagger Open Source lead at SmartBear. Lukas Rosenstock is an independent software developer and API consultant.

This book clearly presents patterns and techniques that will enhance the experience for all software developers who need to work with APIs!

From the Foreword by Tony Tam, Founder of Swagger

Everyone in the business of designing APIs should read this book!

Pierre-Michel Ansel, 8x8

Essential advice for design-first API development.

Ian Lovell, Cutover

A must-read for individuals and teams that are building APIs.

Foster Haines, Senior Consultant at J2 Interactive

choose your plan

team

monthly
annual
$49.99
$499.99
only $41.67 per month
  • five seats for your team
  • access to all Manning books, MEAPs, liveVideos, liveProjects, and audiobooks!
  • choose another free product every time you renew
  • choose twelve free products per year
  • exclusive 50% discount on all purchases
  • Designing APIs with Swagger and OpenAPI ebook for free

choose your plan

team

monthly
annual
$49.99
$499.99
only $41.67 per month
  • five seats for your team
  • access to all Manning books, MEAPs, liveVideos, liveProjects, and audiobooks!
  • choose another free product every time you renew
  • choose twelve free products per year
  • exclusive 50% discount on all purchases
  • Designing APIs with Swagger and OpenAPI ebook for free

choose your plan

team

monthly
annual
$49.99
$499.99
only $41.67 per month
  • five seats for your team
  • access to all Manning books, MEAPs, liveVideos, liveProjects, and audiobooks!
  • choose another free product every time you renew
  • choose twelve free products per year
  • exclusive 50% discount on all purchases
  • Designing APIs with Swagger and OpenAPI ebook for free