.net6 minimal API - OpenApiOperation Attribute does not work

説明

var app = builder.Build();
app.MapPost("/Test", Test).WithTags("MyTag");

[OpenApiOperation("MySummary", "MyDescription")]
static string Test(string foo) {
    return foo;
}

コントリビューターガイド

技術スタック

csharprest api

領域

apidocumentationbackend

Issue 種別

bug

難度新しい貢献者にとっての実装難度です。1 は非常に小さな変更、5 は専門的な作業です。

3

推定時間経験ある貢献者が調査、実装、テスト、pull request 準備にかけるおおよその時間範囲です。

1-3 hours

活動状況Issue が今どれだけ取り組みやすいかを示します。新しい、活発、古い、ブロック中、またはメンテナー入力待ちなどです。

stale

明確さ期待される変更、受け入れ条件、次の手順がどれだけ明確かを示します。

clear

前提条件

Familiarity with .NET 6 minimal APIsBasic understanding of NSwag and OpenAPI attributes

初心者向け度初回貢献者にどれだけ取り組みやすいかを 1-100 で推定したスコアです。

45

調査方針

Investigate how the OpenApiOperation attribute from NSwag.Annotations is handled in the context of .NET minimal APIs. Review the NSwag source code, particularly the operation processor or filter that reads this attribute, and compare with the traditional controller based approach. Check if there are any recent commits or discussions on this issue (issue #3802) that indicate a known workaround or planned fix. The expected outcome is a minimal reproduction or a patch that makes the attribute work with app.MapPost.