요약 : ChatGPT
-
Swagger UI 개요
- 웹 API 문서를 위한 인터랙티브 웹 기반 도구.
- 2020년부터 2024년까지 ASP.NET Core에서 기본 제공으로 인기.
- 무료 및 유료 서비스 제공.
-
OpenAPI 개요
- REST API를 정의하는 표준 사양.
- 공식 사이트: openapis.org, Microsoft 문서: aka.ms/aspnet/openapi.
-
.NET 9에서 Swagger UI 제거
- 외부 도구 의존성 감소를 위해 .NET 9에서 제거.
- Swashbuckle.AspNetCore는 유지 관리 부족과 .NET 8 지원 업데이트가 없었음.
-
Microsoft.AspNetCore.OpenApi 패키지
- OpenAPI 문서를 위한 새로운 내장 도구.
- 외부 종속성을 줄여 더 빠른 릴리스 주기 가능.
-
커뮤니티 반응
- Swashbuckle 프로젝트에 기여하거나 포크하는 방안 논의.
- Microsoft는 Swashbuckle 및 NSwag와의 협력 가능성도 탐색.
-
변경 이유
- 외부 라이브러리 의존성 감소.
- ASP.NET Core에 대한 네이티브 OpenAPI 지원 제공.
-
Microsoft.AspNetCore.OpenApi의 장점
- 네이티브 지원과 의존성 감소.
- 설정 간소화 및 Minimal API 지원.
- Swagger 및 NSwag 같은 기존 도구와의 호환성.
-
.NET 9에서 OpenAPI 사용 방법
Microsoft.AspNetCore.OpenApiNuGet 패키지 추가.- 서비스와 미들웨어 설정:
builder.Services.AddOpenApi(),app.MapOpenApi().
-
대체 도구: Scalar
- 오픈 소스 API 문서화 도구.
- OpenAPI 및 Swagger 지원, GitHub에서 7K 이상의 별.
- 레포지토리: Scalar on GitHub.