Building APIs with Swagger and the OpenAPI Specification

Course details

The Swagger platform offers a rich ecosystem of tools that developers can use to create well-crafted APIs that boast higher adoption rates. Curious about how to leverage Swagger in your workflow? In this course, learn how to build and document high-quality APIs with Swagger and the OpenAPI Specification. After going over the basics of the Swagger ecosystem, instructor Kevin Bowersox shows how to build API definitions that speed up the delivery of APIs using the OpenAPI Specification. He also shows how to create and publish APIs with SwaggerHub, an integrated API development platform. To wrap up, Kevin steps through a hands-on project that shows you how to plan API development for applications.

Learning objectives
The architecture of the Swagger ecosystem
Using the tools within the Swagger platform
Building a basic API using Swagger
Defining APIs
Creating API documentation using Swagger UI
Creating and publishing APIs with SwaggerHub
API management with Apigee
Monitoring API usage

Concepts

0. Introduction

01 - Building APIs with Swagger
02 - What you should know
03 - Demo project overview
04 - Updates to this course

1. Swagger Ecosystem

05 - Swagger ecosystem
06 - Open-source tools
07 - OpenAPI Specification
08 - Open-source tool installation
09 - H+ Sport intro
10 - Building a simple API
11 - Challenge - Retrieve company blog posts
12 - Solution - Retrieve company blog posts

2. Building API Specifications

13 - Defining APIs
14 - Reading the specification
15 - Paths with query parameters
16 - Template parameters in paths
17 - Building posts with request bodies
18 - Achieving reusability with components
19 - Response objects
20 - Reusing parameters
21 - Content negotiation
22 - Swagger UI
23 - Challenge - Create company blog posts
24 - Solution - Create company blog posts

3. Creating and Publishing APIs with SwaggerHub

25 - Building APIs within SwaggerHub
26 - Getting started with SwaggerHub
27 - Building API definitions from templates
28 - Versioning APIs in SwaggerHub
29 - Importing API definitions
30 - Security schemes
31 - Domains
32 - Nesting schemas in domains
33 - Enforcing API standards
34 - Auto Mocking APIs
35 - Adding organization members
36 - Inviting individual collaborators
37 - Challenge - Publish the blog API
38 - Solution - Publish the blog API

4. Capstone Project

39 - Project architecture
40 - Generating server stubs and client SDKs
41 - Building an API client
42 - Client SDK internals
43 - API implementation
44 - Packaging the API implementation
45 - Hosting APIs in Azure
46 - API server setup
47 - Publishing public APIs
48 - API management with Apigee
49 - Monitoring API usage
50 - Client modifications

Conclusion

51 - Next steps

Building APIs with Swagger and the OpenAPI Specification

Authors

Kevin Bowersox