关于 d1-03-swagger
用于在 ASP.NET Core API 中配置 Swagger UI 的技能。它先检查现有 OpenAPI 配置,并说明需要界面时如何添加 Swashbuckle。
主要功能
- 01检查现有 OpenAPI 配置
- 02添加 Swashbuckle 包
- 03配置 Swagger UI
适用场景
- 01提供交互式 API 文档
- 02为 ASP.NET Core API 添加 Swagger UI
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ softinter-chiangrai/ up-ai-skill-training --skill d1-03-swagger安装后在 Claude Code 中输入/d1-03-swagger确认已加载。
详细介绍
第 1 天 · 步骤 3 — Swagger
先检查 up-api/Program.cs——较新的 dotnet new webapi 模板已自带 OpenAPI 配置
(AddOpenApi() / MapOpenApi())。如果需要 Swagger UI(而不仅仅是原始 OpenAPI JSON),
请添加 Swashbuckle:
cd up-api
dotnet add package Swashbuckle.AspNetCore
在 Program.cs 中:
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();
// ...
app.UseSwagger();
app.UseSwaggerUI();
评论
支持 Markdown