Swagger and the OpenAPI Specification

• A basic understanding of REST APIs
• Experience with JSON or XML formats
• Object-orientated programming experience

Audience

• Back-end Developers

Swagger is an open source framework of tools that use Open API Specification (OAS) files for building, designing, documenting, and consuming RESTful web services.

This instructor-led, live training (online or onsite) is aimed at back-end developers who wish to use Swagger to build, design, document, and consume RESTful web services.

By the end of this training, participants will be able to:

• Create an API management strategy for software infrastructure.
• Use Swagger tools to edit OAS files and create SDKs.
• Implement API security, versioning, documentation, and other important features.

Format of the Course

• Interactive lecture and discussion.
• Lots of exercises and practice.
• Hands-on implementation in a live-lab environment.

Course Customization Options

• To request a customized training for this course, please contact us to arrange.

Introduction

API Definition

• Definition file
• API request

YAML

• What is YAML
• Rules of YAML

Overview of RESTful Services

• Resoures
• State transfer
• Representation sate

Preparing the Development Environment

• Installing and configuring Swagger
• Installing and configuring Node.Js

REST Web Service Constraint Architecture

• Using the client-server constraint
• Working with uniform interface constraints
• Working with the statelessness constraint
• Using HTTP-caching
• Enabling a layer system

REST API Designing

• Implementing CRUD operations
• Using Error Handling
• Implementing operations for REST APIs
• Handling changes in API
• Versioning API
• Caching API
• Supporting pagination and partial responses

Specifications using Swagger

• Editing documents with Swagger
• Creating specifications in YAML format
• Creating paths and observations
• Adding documentation
• Adding schemas to an OAS file
• Using SwaggerHub

API Management

• Creating an API management strategy
• Managing the API life cycle
• Generating API proxies
• Controling the behavior of API
• Building an API portal
• Providing traffic management

API Security

• Securing with tokens and JWT
• Securing with API key and secret
• Authorizing using OAuth2.0

Summary and Conclusion