Skip to content

Min Web API Tutorial Complete Rewrite and 8 app sample update #37302

Description

@wadepickett

Description

Rewrite the Minimal Web API tutorial to:

  • Change the starting point from an empty project to the OpenAPI-enabled Web API template where most developers would start. Visual Studio now uses the ASP.NET Core Web API project type (with "Enable OpenAPI support" checked and "Use controllers" unchecked); the CLI switches from dotnet new web to dotnet new webapi.

  • Replace the old Swagger/NSwag testing approach with the built-in OpenAPI document generator (AddOpenApi() / MapOpenApi()), and uses Scalar (Scalar.AspNetCore) as the browser UI for VS Code instead of NSwag's Swagger UI. Visual Studio continues to use Endpoints Explorer + .http files.

  • Update all 8 app samples used by this tutorial for .NET 10 using the ASP.NET Core Web API (webapi for CLI) template.

After this PR is completed/merged:
Update in a new PR refer to final complete app version VS (using .http testing files) and VS Code (using Swagger UI)version on the AspNetCore.docs.samples repo which can be run in Codespaces

Page URL

https://learn.microsoft.com/en-us/aspnet/core/tutorials/min-web-api?view=aspnetcore-10.0&tabs=visual-studio

Content source URL

https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/tutorials/min-web-api.md

Document ID

ab408035-6313-a183-9940-32de00e0e977

Platform Id

bb56f646-dd6c-15ea-7789-1492b2e548e8

Article author

@wadepickett

Metadata

  • ID: ab408035-6313-a183-9940-32de00e0e977
  • PlatformId: bb56f646-dd6c-15ea-7789-1492b2e548e8
  • Service: aspnet-core
  • Sub-service: tutorials

Related Issues


Associated WorkItem - 593687

Metadata

Metadata

Assignees

Type

No type

Fields

No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions