Documenting an ASP.NET Core Web API Using Swagger from Pluralsight

Documenting an API is essential. By using Swagger (OpenAPI), which integrates nicely with ASP.NET Core, you can take on this task. In this course you'll learn how to do that.

Documenting an API is often regarded as a tedious, yet essential, task. In this course, Documenting an ASP.NET Core Web API using Swagger, you'll use Swagger (OpenAPI), which integrates nicely with ASP.NET Core, to take on this task. First, you'll discover how to add documentation for your API and add a UI that allows testing the API. Next, you'll see that built-in conventions already go a long way towards generating an OpenAPI specification for your API, but you can override them when needed. Finally, you'll learn how to customize the UI of the generated documentation, and what other use cases there are for OpenAPI - like generating automated tests for your API and generating client-side code from the specification. When you're finished with this course you'll know the ins and outs of OpenAPI and how it can help with documenting your API and more.

What's inside

Syllabus

Course Overview

Getting Started with OpenAPI (Swagger)

Documenting Your First API with OpenAPI (Swagger)

Customizing OpenAPI Generation with Attributes and Conventions

Generating OpenAPI Specifications for Advanced Input and Output Scenarios

Dealing with Different Versions and Protecting the Documentation

Improving Your Documentation with Advanced Customization

Good to know

Know what's good

, what to watch for

, and possible dealbreakers

Develops documentation skills for RESTful APIs, a core skill for fullstack developers

Suitable for beginners new to API development

Uses Swagger (OpenAPI), an industry-standard tool for API documentation

Taught by Kevin Dockx, who has extensive experience in API development

Provides hands-on labs and interactive materials for practical learning

May require prior programming knowledge and understanding of RESTful APIs

Career center

Learners who complete Documenting an ASP.NET Core Web API Using Swagger will develop knowledge and skills that may be useful to these careers:

Software Architect

A Software Architect designs and builds software systems. They use tools like Swagger (OpenAPI) to document the APIs that these systems use. The course will help you learn how to use Swagger to generate OpenAPI specifications for your APIs, which can help improve the quality and consistency of your documentation.

See salaries and explore the career path for Software Architect

API Developer

An API Developer designs, builds, and maintains APIs. They use tools like Swagger (OpenAPI), which integrates nicely with ASP.NET Core, to document these APIs. The course will help you learn how to use Swagger to generate OpenAPI specifications for your APIs, which can help improve the quality and consistency of your documentation.

See salaries and explore the career path for API Developer

DevOps Engineer

A DevOps Engineer works with developers and operations teams to ensure that software is built and deployed efficiently. They use tools like Swagger (OpenAPI) to document the APIs that are used in the development and deployment process. The course will help you learn how to use Swagger to generate OpenAPI specifications for your APIs, which can help improve the quality and consistency of your documentation.

See salaries and explore the career path for DevOps Engineer

Cloud Architect

A Cloud Architect designs and builds cloud-based systems. They use tools like Swagger (OpenAPI) to document the APIs that are used to access and manage these systems. The course will help you learn how to use Swagger to generate OpenAPI specifications for your APIs, which can help improve the quality and consistency of your documentation.

See salaries and explore the career path for Cloud Architect

Data Architect

A Data Architect designs and builds data systems. They use tools like Swagger (OpenAPI) to document the APIs that are used to access and manipulate data in these systems. The course will help you learn how to use Swagger to generate OpenAPI specifications for your APIs, which can help improve the quality and consistency of your documentation.

See salaries and explore the career path for Data Architect

Systems Analyst

A Systems Analyst analyzes and designs business systems. They use tools like Swagger (OpenAPI) to document the APIs that are used in these systems. The course will help you learn how to use Swagger to generate OpenAPI specifications for your APIs, which can help improve the quality and consistency of your documentation.

See salaries and explore the career path for Systems Analyst

Technical Writer

A Technical Writer creates documentation for software and other technical products. They use tools like Swagger (OpenAPI) to generate API documentation. The course will help you learn how to use Swagger to generate OpenAPI specifications for your APIs, which can help improve the quality and consistency of your documentation.

See salaries and explore the career path for Technical Writer

Software Engineer

A Software Engineer designs, builds, and tests software. They use tools like Swagger (OpenAPI) to document the APIs that are used in their software. The course will help you learn how to use Swagger to generate OpenAPI specifications for your APIs, which can help improve the quality and consistency of your documentation.

See salaries and explore the career path for Software Engineer

Web Developer

A Web Developer designs and builds websites and web applications. They use tools like Swagger (OpenAPI) to document the APIs that are used in their websites and applications. The course will help you learn how to use Swagger to generate OpenAPI specifications for your APIs, which can help improve the quality and consistency of your documentation.

See salaries and explore the career path for Web Developer

Quality Assurance Engineer

A Quality Assurance Engineer tests software to ensure that it meets the requirements of the users. They use tools like Swagger (OpenAPI) to document the APIs that are used in the software. The course will help you learn how to use Swagger to generate OpenAPI specifications for your APIs, which can help improve the quality and consistency of your documentation.

See salaries and explore the career path for Quality Assurance Engineer

Information Security Analyst

An Information Security Analyst protects computer systems and networks from unauthorized access, use, disclosure, disruption, modification, or destruction. They use tools like Swagger (OpenAPI) to document the APIs that are used in these systems and networks. The course will help you learn how to use Swagger to generate OpenAPI specifications for your APIs, which can help improve the quality and consistency of your documentation.

See salaries and explore the career path for Information Security Analyst

UX Designer

A UX Designer designs the user experience for software and other products. They use tools like Swagger (OpenAPI) to document the APIs that are used in the product. The course will help you learn how to use Swagger to generate OpenAPI specifications for your APIs, which can help improve the quality and consistency of your documentation.

See salaries and explore the career path for UX Designer

Project Manager

A Project Manager plans and executes projects. They use tools like Swagger (OpenAPI) to document the APIs that are used in the project. The course will help you learn how to use Swagger to generate OpenAPI specifications for your APIs, which can help improve the quality and consistency of your documentation.

See salaries and explore the career path for Project Manager

Product Manager

A Product Manager manages the development and marketing of a product. They use tools like Swagger (OpenAPI) to document the APIs that are used in the product. The course will help you learn how to use Swagger to generate OpenAPI specifications for your APIs, which can help improve the quality and consistency of your documentation.

See salaries and explore the career path for Product Manager

Business Analyst

A Business Analyst analyzes the business needs of an organization and develops solutions to meet those needs. They use tools like Swagger (OpenAPI) to document the APIs that are used in the solutions. The course will help you learn how to use Swagger to generate OpenAPI specifications for your APIs, which can help improve the quality and consistency of your documentation.

See salaries and explore the career path for Business Analyst