GitHub profile
.NET Framework .NET C# VB.NET LINQ ASP.NET Web API REST SignalR Windows Forms WPF WCF RabbitMQ PHP SQL Server MySQL PostgreSQL MariaDB SQLite MongoDB ADO.NET ORM Entity Framework Dapper XML JSON HTML5 CSS3 Bootstrap JavaScript jQuery Angular React TypeScript NPM Blazor UI/UX Responsive Web Design Redis Elasticsearch GraphQL Grafana Agile Scrum Kanban Windows Server IIS PowerShell Active Directory TFS Azure Automation Software Reverse Engineering Performance Optimization Git Jira/Confluence CI/CD TeamCity SOLID KISS DRY YAGNI
Books for developers
Always will be ready notify the world about expectations as easy as possible: job change page

Designing APIs with Swagger and OpenAPI

Designing APIs with Swagger and OpenAPI

Author: Joshua S. Ponelat, Lukas L. Rosenstock
Year: 2022
Format: PDF
Pages: 426
Views: 150

17.69 MB

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.

Table of Contents


1. Introducing APIs and OpenAPI
2. Getting set up to make API requests
3. Our first taste of OpenAPI definitions
4. Using Swagger Editor to write OpenAPI definitions
5. Describing API responses
6.Creating resources
7. Adding authentication and authorization
8. Preparing and hosting API documentation


9. Designing a web application
10. Creating an API design using OpenAPI
11. Building a change workflow around API design–first
12. Implementing frontend code and reacting to changes
13. Building a backend with Node.js and Swagger Codegen
14. Integrating and releasing the web application


15. Designing the next API iteration
16. Designing schemas with composition in OpenAPI
17. Scaling collection endpoints with filters and pagination
18. Supporting the unhappy path: Error handling with problem+json
19. Improving input validation with advanced JSON Schema
20. Versioning an API and handling breaking changes
21. The API prerelease checklist

JavaScript for sound artists
Автор: William Turner, Steve Leonard
Год: 2017
Страниц: 254
Learn how to program JavaScript while creating interactive audio applications with JavaScript for Sound Artists: Learn to Code With the Web Audio API! William Turner and Steve Leonard showcase the basics of JavaScript language programing so that readers can learn...
Pro REST API Development with Node.js
Автор: Fernando Doglio
Год: 2015
Страниц: 196
Pro REST API Development with Node.js is your guide to managing and understanding the full capabilities of successful REST development. API design is a hot topic in the programming world, but not many resources exist for developers to really understand...
Mastering ASP.NET Web API
Автор: Mithun Pattankar, Malendra Hurbuns
Год: 2017
Страниц: 330
Microsoft has unified their main web development platforms. This unification will help develop web applications using various pieces of the ASP.NET platform that can be deployed on both Windows and LINUX. With ASP.NET Core (Web API), it will become easier...
Ultimate ASP.NET Core Web API
Автор: Marinko Spasojevic, Vladimir Pecanac
Год: 2021
Страниц: 288
A complete, hands-on, and easy to digest program that gets you from zero to building production-ready APIs in just a few weeks....
Send message
Your name

© 1999–2023 WebDynamics
1980–... Sergey Drozdov
Area of interests: .NET | .NET Core | C# | ASP.NET | Windows Forms | WPF | Windows Phone | HTML5 | CSS3 | jQuery | AJAX | MS SQL Server | Transact-SQL | ADO.NET | Entity Framework | IIS | OOP | OOA | OOD | WCF | WPF | MSMQ | MVC | MVP | MVVM | Design Patterns | Enterprise Architecture | Scrum | Kanban