{"id":983,"date":"2025-01-23T21:33:54","date_gmt":"2025-01-24T05:33:54","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/dotnet-ch\/?p=983"},"modified":"2025-01-23T21:33:54","modified_gmt":"2025-01-24T05:33:54","slug":"net-9-%e4%b8%ad%e7%9a%84-openapi-%e6%96%87%e6%a1%a3%e7%94%9f%e6%88%90","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/dotnet-ch\/net-9-%e4%b8%ad%e7%9a%84-openapi-%e6%96%87%e6%a1%a3%e7%94%9f%e6%88%90\/","title":{"rendered":".NET 9 \u4e2d\u7684 OpenAPI \u6587\u6863\u751f\u6210"},"content":{"rendered":"<p style=\"text-align: center;\"><em><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u672c\u6587\u7ffb\u8bd1\u81ea<a class=\"read-more\" href=\"https:\/\/devblogs.microsoft.com\/dotnet\/author\/mikekistler\" data-bi-area=\"body_author_top\" data-bi-id=\"post_page_body_author_top_name\" data-bi-name=\"Mike Kistler\">Mike Kistler<\/a>\u7684<a href=\"https:\/\/devblogs.microsoft.com\/dotnet\/dotnet9-openapi\/\">OpenAPI document generation in .NET 9<\/a><\/span><\/em><\/p>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">.NET 9 \u4e2d\u7684 ASP.NET Core \u901a\u8fc7\u5f15\u5165\u5168\u65b0\u7684\u5bf9OpenAPI \u6587\u6863\u751f\u6210\u529f\u80fd\u7684\u5185\u7f6e\u652f\u6301\uff0c\u7b80\u5316\u4e86\u4e3a API \u7aef\u70b9\u521b\u5efa OpenAPI \u6587\u6863\u7684\u8fc7\u7a0b\u3002\u8fd9\u9879\u65b0\u529f\u80fd\u65e8\u5728\u7b80\u5316\u5f00\u53d1\u5de5\u4f5c\u6d41\u7a0b\uff0c\u5e76\u6539\u5584 OpenAPI \u5b9a\u4e49\u5728 ASP.NET \u5e94\u7528\u4e2d\u7684\u96c6\u6210\u3002 OpenAPI \u7684\u5e7f\u6cdb\u4f7f\u7528\u50ac\u751f\u4e86\u4e30\u5bcc\u7684\u5de5\u5177\u548c\u670d\u52a1\u751f\u6001\u7cfb\u7edf\uff0c\u5b83\u4eec\u80fd\u591f\u5e2e\u52a9\u60a8\u66f4\u9ad8\u6548\u5730\u6784\u5efa\u3001\u6d4b\u8bd5\u548c\u8bb0\u5f55 API\u3002\u4f8b\u5982\uff0c<a href=\"https:\/\/swagger.io\/tools\/swagger-ui\/\">Swagger UI<\/a>\u3001<a href=\"https:\/\/learn.microsoft.com\/openapi\/kiota\/\">Kiota \u5ba2\u6237\u7aef\u5e93\u751f\u6210\u5668<\/a>\u548c <a href=\"https:\/\/redoc.ly\/\">Redoc<\/a> \u7b49\uff0c\u5f53\u7136\u8fd8\u6709\u8bb8\u591a\u5176\u4ed6\u5de5\u5177\u3002\u00a0<\/span><\/p>\n<h2><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 18pt;\"><b>\u4e3a\u4ec0\u4e48\u9009\u62e9 OpenAPI\uff1f<\/b>\u00a0<\/span><\/h2>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\"><a href=\"https:\/\/www.openapis.org\/what-is-openapi\">OpenAPI<\/a> \u662f\u5b9a\u4e49\u548c\u8bb0\u5f55 HTTP API \u7684\u5f3a\u5927\u5de5\u5177\u3002\u5b83\u63d0\u4f9b\u4e86\u4e00\u79cd\u6807\u51c6\u5316\u65b9\u5f0f\u6765\u63cf\u8ff0 API \u7684\u7aef\u70b9\u3001\u8bf7\u6c42\u548c\u54cd\u5e94\u683c\u5f0f\u3001\u8eab\u4efd\u9a8c\u8bc1\u65b9\u6848\u4ee5\u53ca\u5176\u4ed6\u91cd\u8981\u7ec6\u8282\u3002\u8fd9\u79cd\u6807\u51c6\u5316\u4f7f\u5f00\u53d1\u4eba\u5458\u80fd\u591f\u66f4\u8f7b\u677e\u5730\u4e86\u89e3\u548c\u4e0eAPI\u8fdb\u884c\u4ea4\u4e92\uff0c\u4ece\u800c\u4fc3\u8fdb\u66f4\u597d\u7684\u534f\u4f5c\u5e76\u6784\u5efa\u66f4\u5f3a\u5927\u7684\u5e94\u7528\u7a0b\u5e8f\u3002\u00a0<\/span><\/p>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u6b64\u5916\uff0c\u8bb8\u591a\u5927\u578b\u8bed\u8a00\u6a21\u578b\uff08LLMs\uff09\u5df2\u5728 OpenAPI \u6587\u6863\u4e0a\u8fdb\u884c\u4e86\u8bad\u7ec3\uff0c\u4f7f\u5176\u80fd\u591f\u81ea\u52a8\u751f\u6210\u4ee3\u7801\u3001\u6d4b\u8bd5\u7528\u4f8b\u548c\u5176\u4ed6\u5de5\u4ef6\u3002\u901a\u8fc7\u4e3a\u60a8\u7684 API \u751f\u6210 OpenAPI \u6587\u6863\uff0c\u60a8\u53ef\u4ee5\u5229\u7528\u8fd9\u4e9b LLM \u6765\u52a0\u901f\u5f00\u53d1\u6d41\u7a0b\u3002\u00a0<\/span><\/p>\n<h2><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 18pt;\"><b>.NET 9 \u4e2d\u7684\u65b0\u529f\u80fd\uff1f<\/b>\u00a0<\/span><\/h2>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u5728 .NET 9 \u4e2d\uff0c\u6211\u4eec\u5f15\u5165\u4e86\u5bf9 OpenAPI \u6587\u6863\u751f\u6210\u529f\u80fd\u7684\u5185\u7f6e\u652f\u6301\uff0c\u4e3a .NET \u5f00\u53d1\u4eba\u5458\u63d0\u4f9b\u4e86\u66f4\u96c6\u6210\u3001\u66f4\u6d41\u7545\u7684\u4f53\u9a8c\u3002\u6b64\u529f\u80fd\u53ef\u7528\u4e8eMinimal API \u548c\u57fa\u4e8e\u63a7\u5236\u5668\u7684\u5e94\u7528\u7a0b\u5e8f\u3002\u4ee5\u4e0b\u662f\u4e00\u4e9b\u5173\u952e\u4eae\u70b9\uff1a\u00a0<\/span><\/p>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"2\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"1\" data-aria-level=\"1\"><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u652f\u6301\u5728\u8fd0\u884c\u65f6\u751f\u6210 OpenAPI \u6587\u6863\uff0c\u5e76\u901a\u8fc7\u5e94\u7528\u7a0b\u5e8f\u4e0a\u7684\u7aef\u70b9\u8bbf\u95ee\u5b83\u4eec\uff0c\u6216\u5728\u6784\u5efa\u65f6\u751f\u6210\u6587\u6863\u3002\u00a0<\/span><\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"2\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"2\" data-aria-level=\"1\"><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u7528\u4e8e\u5c06\u5143\u6570\u636e\u6dfb\u52a0\u5230 API \u65b9\u6cd5\u548c\u6570\u636e\u7684\u5c5e\u6027\u548c\u6269\u5c55\u65b9\u6cd5 \u3002\u00a0<\/span><\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"2\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"3\" data-aria-level=\"1\"><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u652f\u6301\u201c\u8f6c\u6362\u5668\u201dAPI\uff0c\u5141\u8bb8\u4ee5\u591a\u79cd\u65b9\u5f0f\u4fee\u6539\u751f\u6210\u7684\u6587\u6863\u3002\u00a0<\/span><\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"2\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"4\" data-aria-level=\"1\"><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u652f\u6301\u4ece\u5355\u4e2a\u5e94\u7528\u7a0b\u5e8f\u751f\u6210\u591a\u4e2a OpenAPI \u6587\u6863\u3002\u00a0<\/span><\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"2\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"5\" data-aria-level=\"1\"><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u5229\u7528 <a href=\"https:\/\/learn.microsoft.com\/dotnet\/api\/system.text.json\">System.Text.Json<\/a> \u63d0\u4f9b\u7684 JSON schema \u652f\u6301\u3002\u00a0<\/span><\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"2\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"6\" data-aria-level=\"1\"><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u4e0eMinimal API \u7ed3\u5408\u4f7f\u7528\u65f6\uff0c\u517c\u5bb9\u539f\u751f AoT\uff08Ahead-of-Time\uff09\u7f16\u8bd1\u3002\u00a0<\/span><\/li>\n<\/ul>\n<h2><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 18pt;\"><b>\u5982\u4f55\u5165\u95e8<\/b>\u00a0<\/span><\/h2>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u5728 .NET 9 \u4e2d\u4f7f\u7528\u65b0\u7684 OpenAPI \u6587\u6863\u751f\u6210\u529f\u80fd\u975e\u5e38\u7b80\u5355\u3002\u4ee5\u4e0b\u662f\u4e00\u4e2a\u5e2e\u52a9\u60a8\u5165\u95e8\u7684\u5feb\u901f\u6307\u5357\u3002\u00a0<\/span><\/p>\n<h3><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 14pt;\"><b>\u66f4\u65b0\u5230 .NET 9<\/b>\u00a0<\/span><\/h3>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u786e\u4fdd\u60a8\u7684\u9879\u76ee\u4f7f\u7528\u7684\u662f\u672c\u6708\u521d\u53d1\u5e03\u7684 .NET 9\u3002\u60a8\u53ef\u4ee5\u4ece <a href=\"https:\/\/get.dot.net\/9\">\u00a0.NET \u5b98\u65b9\u7f51\u7ad9<\/a> \u4e0b\u8f7d\u6700\u65b0\u7248\u672c\u3002\u00a0<\/span><\/p>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u5982\u679c\u60a8\u60f3\u4e3a\u73b0\u6709\u9879\u76ee\u6dfb\u52a0 OpenAPI \u652f\u6301\uff0c\u5219\u9700\u8981\u5c06\u9879\u76ee\u7684\u76ee\u6807\u6846\u67b6\u66f4\u65b0\u4e3a .NET 9\u3002\u6709\u5173\u8be6\u7ec6\u7684\u8fc1\u79fb\u6307\u5357\uff0c\u8bf7\u53c2\u9605 <a href=\"https:\/\/learn.microsoft.com\/aspnet\/core\/migration\/80-90?view=aspnetcore-9.0\">ASP.NET Core \u6587\u6863<\/a>\u4e2d\u7684\u76f8\u5173\u5185\u5bb9\u3002\u00a0<\/span><\/p>\n<h3><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 14pt;\"><b>\u542f\u7528 OpenAPI \u652f\u6301<\/b>\u00a0<\/span><\/h3>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u5982\u679c\u60a8\u6b63\u5728\u521b\u5efa\u4e00\u4e2a\u65b0\u9879\u76ee\uff0cOpenAPI \u652f\u6301\u5df2\u7ecf\u5185\u7f6e\u5728 NET9. <code>Webapi<\/code> \u6a21\u677f\u4e2d\u3002\u00a0<\/span><\/p>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u8981\u5728\u73b0\u6709\u9879\u76ee\u4e2d\u542f\u7528 OpenAPI \u6587\u6863\u652f\u6301\uff0c\u60a8\u53ea\u9700\u6dfb\u52a0 <a href=\"https:\/\/www.nuget.org\/packages\/Microsoft.AspNetCore.OpenApi\">Microsoft.AspNetCore.OpenApi<\/a> \u5305\uff0c\u5e76\u5728\u4e3b\u5e94\u7528\u7a0b\u5e8f\u6587\u4ef6\u4e2d\u6dfb\u52a0\u51e0\u884c\u4ee3\u7801\u3002\u00a0<\/span><\/p>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u60a8\u53ef\u4ee5\u901a\u8fc7\u547d\u4ee4 <code>dotnet add package<\/code> \u6dfb\u52a0\u8be5\u5305\uff1a\u00a0<\/span><\/p>\n<pre class=\"prettyprint language-default\"><code class=\"language-default\">dotnet add package Microsoft.AspNetCore.OpenApi<\/code><\/pre>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u63a5\u7740\uff0c\u60a8\u9700\u8981\u5728 <code>Program.cs<\/code> \u6587\u4ef6\u4e2d\u5c06 OpenAPI \u670d\u52a1\u6dfb\u52a0\u5230 WebApplicationBuilder\uff1a\u00a0<\/span><\/p>\n<pre class=\"prettyprint language-default\"><code class=\"language-default\">builder.Services.AddOpenApi();<\/code><\/pre>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">OpenAPI \u529f\u80fd\u63d0\u4f9b\u4e86\u5404\u79cd\u914d\u7f6e\u9009\u9879\uff0c\u4f8b\u5982\u8bbe\u7f6e\u6587\u6863\u6807\u9898\u3001\u7248\u672c\u548c\u5176\u4ed6\u5143\u6570\u636e\u3002\u60a8\u53ef\u4ee5\u5728 <a href=\"https:\/\/learn.microsoft.com\/en-us\/aspnet\/core\/fundamentals\/openapi\/overview?view=aspnetcore-9.0\">ASP.NET Core \u6587\u6863<\/a>\u4e2d\u627e\u5230\u6709\u5173\u8fd9\u4e9b\u9009\u9879\u7684\u66f4\u591a\u4fe1\u606f\u3002\u00a0<\/span><\/p>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u7136\u540e\uff0c\u5728\u5e94\u7528\u7a0b\u5e8f\u4e2d\u6dfb\u52a0\u7aef\u70b9\uff0c\u901a\u8fc7 <code>MapOpenApi<\/code> \u6269\u5c55\u65b9\u6cd5\u4e3a OpenAPI \u6587\u6863\u63d0\u4f9b\u670d\u52a1\uff0c\u5982\u4e0b\u6240\u793a\uff1a\u00a0<\/span><\/p>\n<pre class=\"prettyprint language-default\"><code class=\"language-default\">app.MapOpenApi();<\/code><\/pre>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u73b0\u5728\uff0c\u60a8\u53ef\u4ee5\u8fd0\u884c\u60a8\u7684\u5e94\u7528\u7a0b\u5e8f\uff0c\u5e76\u5728 <code>\/openapi\/v1.json<\/code> \u7aef\u70b9\u8bbf\u95ee\u751f\u6210\u7684 OpenAPI \u6587\u6863\u3002\u00a0<\/span><\/p>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u60a8\u5c06\u5728\u8be5\u7aef\u70b9\u770b\u5230\u4e00\u4e2a\u5305\u542b\u8def\u5f84\u3001\u64cd\u4f5c\u548c\u6a21\u5f0f\u7684 OpenAPI \u6587\u6863\uff0c\u8fd9\u4e9b\u5185\u5bb9\u662f\u57fa\u4e8e\u60a8\u7684\u5e94\u7528\u7a0b\u5e8f\u4ee3\u7801\u751f\u6210\u7684\uff0c\u4f46\u53ef\u80fd\u4e0d\u5305\u62ec\u63cf\u8ff0\u548c\u793a\u4f8b\u7b49\u91cd\u8981\u7ec6\u8282\u3002\u8981\u83b7\u53d6\u8fd9\u4e9b\u5143\u7d20\uff0c\u60a8\u9700\u8981\u6309\u7167\u4e0b\u4e00\u8282\u4e2d\u7684\u8bf4\u660e\u6dfb\u52a0\u5143\u6570\u636e\u3002\u00a0<\/span><\/p>\n<h3><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 14pt;\"><b>\u6dfb\u52a0 OpenAPI \u5143\u6570\u636e<\/b>\u00a0<\/span><\/h3>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u63cf\u8ff0\u3001\u6807\u7b7e\u3001\u793a\u4f8b\u548c\u5176\u4ed6\u5143\u6570\u636e\u90fd\u53ef\u4ee5\u88ab\u6dfb\u52a0\u5230 API \u65b9\u6cd5\u548c\u6570\u636e\u4e2d\uff0c\u4ee5\u8d4b\u4e88\u751f\u6210\u7684 OpenAPI \u6587\u6863\u542b\u4e49\u3002\u60a8\u53ef\u4ee5\u4f7f\u7528\u5c5e\u6027\u6216\u6269\u5c55\u65b9\u6cd5\u6dfb\u52a0\u6b64\u5143\u6570\u636e\u3002\u00a0<\/span><\/p>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u60a8\u53ef\u4ee5\u4f7f\u7528 <code>WithSummary<\/code> \u548c <code>WithDescription<\/code> \u6269\u5c55\u65b9\u6cd5\u4e3a\u5e94\u7528\u7a0b\u5e8f\u4e2d\u7684\u6bcf\u4e2a\u7aef\u70b9\u6dfb\u52a0\u6458\u8981\u548c\u63cf\u8ff0\uff1a\u00a0<\/span><\/p>\n<pre class=\"prettyprint language-default\"><code class=\"language-default\">app.MapGet(\"\/hello\", () =&gt; \"Hello, World!\")\r\n    .WithSummary(\"Get a greeting\")\r\n    .WithDescription(\"This endpoint returns a friendly greeting.\");<\/code><\/pre>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u7aef\u70b9\u7684\u6458\u8981\u548c\u63cf\u8ff0\u975e\u5e38\u91cd\u8981\uff0c\u56e0\u4e3a\u5b83\u4eec\u544a\u8bc9\u7528\u6237\uff08\u4ee5\u53ca\u5927\u8bed\u8a00\u6a21\u578bLLM\uff09\u53ef\u4ee5\u901a\u8fc7\u60a8\u7684 API \u5b8c\u6210\u54ea\u4e9b\u64cd\u4f5c\u3002\u00a0<\/span><\/p>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u60a8\u53ef\u80fd\u8fd8\u5e0c\u671b\u5c06\u76f8\u5173\u7684\u7aef\u70b9\u5728\u6587\u6863\u4e2d\u8fdb\u884c\u5206\u7ec4\uff0c\u901a\u5e38\u53ef\u4ee5\u901a\u8fc7\u6807\u7b7e\u6765\u5b9e\u73b0\u3002\u60a8\u53ef\u4ee5\u4f7f\u7528 <code>WithTag<\/code> \u6269\u5c55\u65b9\u6cd5\u4e3a\u7aef\u70b9\u6dfb\u52a0\u6807\u7b7e\uff1a\u00a0<\/span><\/p>\n<pre class=\"prettyprint language-default\"><code class=\"language-default\">app.MapGet(\"\/hello\", () =&gt; \"Hello, World!\")\r\n    .WithTag(\"Greetings\");<\/code><\/pre>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u5f53\u7aef\u70b9\u5177\u6709\u53c2\u6570\u65f6\uff0c\u4e3a\u6bcf\u4e2a\u53c2\u6570\u6dfb\u52a0\u63cf\u8ff0\u662f\u5f88\u91cd\u8981\u7684\uff0c\u5b83\u7528\u4e8e\u89e3\u91ca\u5176\u542b\u4e49\u4ee5\u53ca\u8be5\u53c2\u6570\u5982\u4f55\u88ab\u7aef\u70b9\u4f7f\u7528\u3002\u60a8\u53ef\u4ee5\u4f7f\u7528 <code>[Description]<\/code> \u5c5e\u6027\u4e3a\u53c2\u6570\u6dfb\u52a0\u63cf\u8ff0\uff1a\u00a0<\/span><\/p>\n<pre class=\"prettyprint language-default\"><code class=\"language-default\">app.MapGet(\"\/hello\/{name}\",\r\n(\r\n    [Description(\"The name of the person to greet.\")] string name\r\n) =&gt; $\"Hello, {name}!\")\r\n    .WithSummary(\"Get a personalized greeting\")\r\n    .WithDescription(\"This endpoint returns a personalized greeting.\")\r\n    .WithTag(\"Greetings\");<\/code><\/pre>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u60a8\u8fd8\u53ef\u4ee5\u4f7f\u7528 <code>[Description]<\/code> \u5c5e\u6027\u4e3a\u6570\u636e\u6a21\u578b\u4e2d\u7684\u5c5e\u6027\u6dfb\u52a0\u63cf\u8ff0\uff1a\u00a0<\/span><\/p>\n<pre class=\"prettyprint language-default\"><code class=\"language-default\">public record Person\r\n{\r\n    [Description(\"The person's name.\")]\r\n    public string Name { get; init; }\r\n\r\n    [Description(\"The person's age.\")]\r\n    public int Age { get; init; }\r\n}<\/code><\/pre>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u8fd8\u6709\u8bb8\u591a\u5176\u4ed6\u5143\u6570\u636e\u5c5e\u6027\u7528\u4e8e\u63cf\u8ff0\u53c2\u6570\u548c\u5c5e\u6027\uff0c\u5305\u62ec <code>[MaxLength]<\/code>\uff08\u6700\u5927\u957f\u5ea6\uff09\u3001<code>[Range]<\/code>\uff08\u8303\u56f4\uff09\u3001<code>[RegularExpression]<\/code> \uff08\u6b63\u5219\u8868\u8fbe\u5f0f\uff09\u548c <code>[DefaultValue]<\/code>\uff08\u9ed8\u8ba4\u503c\uff09\u3002\u8bf7\u6ce8\u610f\uff0c\u5728\u57fa\u4e8e\u63a7\u5236\u5668\u7684\u5e94\u7528\u7a0b\u5e8f\u4e2d\uff0c\u8fd9\u4e9b\u5c5e\u6027\u4f1a\u89e6\u53d1\u5728\u6a21\u578b\u7ed1\u5b9a\u671f\u95f4\u6267\u884c\u7684\u9a8c\u8bc1\uff0c\u4f46\u5728Minimal API \u4e2d\uff0c\u5b83\u4eec\u4ec5\u7528\u4e8e\u6587\u6863\u751f\u6210\u3002\u00a0<\/span><\/p>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u8bf7\u53c2\u9605\u6587\u6863\u4e2d\u7684<a href=\"https:\/\/learn.microsoft.com\/aspnet\/core\/fundamentals\/openapi\/include-metadata\">\u5305\u62ec OpenAPI \u5143\u6570\u636e<\/a>\u4e3b\u9898\uff0c\u4e86\u89e3\u6709\u5173\u5c06\u5143\u6570\u636e\u6dfb\u52a0\u5230 API \u65b9\u6cd5\u548c\u6570\u636e\u7684\u66f4\u591a\u4fe1\u606f\u3002\u00a0<\/span><\/p>\n<h3><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 14pt;\"><b>\u81ea\u5b9a\u4e49\u6587\u6863<\/b>\u00a0<\/span><\/h3>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">ASP.NET \u8fd8\u63d0\u4f9b\u4e86\u4e00\u79cd\u4f7f\u7528\u201c\u8f6c\u6362\u5668\u201d\u81ea\u5b9a\u4e49\u751f\u6210\u7684 OpenAPI \u6587\u6863\u7684\u65b9\u6cd5\uff0c\u8f6c\u6362\u5668\u53ef\u4ee5\u5bf9\u6574\u4e2a\u6587\u6863\u3001\u64cd\u4f5c\u6216\u67b6\u6784\u8fdb\u884c\u64cd\u4f5c\u3002\u8f6c\u6362\u5668\u662f\u5b9e\u73b0 <code>IOpenApiDocumentTransformer<\/code>\u3001<code>IOpenApiOperationTransformer<\/code> \u6216 <code>IOpenApiSchemaTransformer<\/code> \u63a5\u53e3\u7684\u7c7b\u3002\u6bcf\u4e2a\u63a5\u53e3\u90fd\u6709\u4e00\u4e2a\u5f02\u6b65\u65b9\u6cd5\uff0c\u7528\u4e8e\u63a5\u6536\u8981\u8f6c\u6362\u7684\u6587\u6863\u3001\u64cd\u4f5c\u6216\u67b6\u6784\u4ee5\u53ca\u63d0\u4f9b\u5176\u4ed6\u4fe1\u606f\u7684\u4e0a\u4e0b\u6587\u5bf9\u8c61\u3002\u4f20\u9012\u7ed9\u8f6c\u6362\u5668\u7684 OpenAPI \u6587\u6863\u3001\u64cd\u4f5c\u6216\u67b6\u6784\u662f\u4f7f\u7528 <a href=\"https:\/\/learn.microsoft.com\/dotnet\/api\/microsoft.openapi.models\">Microsoft.OpenApi.Models<\/a> \u547d\u540d\u7a7a\u95f4\u4e2d\u7c7b\u578b\u7684\u5f3a\u7c7b\u578b\u5bf9\u8c61\u3002\u8be5\u65b9\u6cd5\u901a\u8fc7\u4fee\u6539\u5b83\u63a5\u6536\u5230\u7684\u5bf9\u8c61\u6765\u201c\u539f\u5730\u201d\u6267\u884c\u8f6c\u6362\u3002\u00a0<\/span><\/p>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u8f6c\u6362\u5668\u901a\u8fc7 <code>AddOpenApi<\/code> \u8c03\u7528\u7684 <code>configureOptions<\/code> \u59d4\u6258\u53c2\u6570\u6dfb\u52a0\uff0c\u5e76\u4e14\u53ef\u4ee5\u6307\u5b9a\u4e3a\u7c7b\u7684\u5b9e\u4f8b\u3001\u4ee5 DI \u6fc0\u6d3b\u7684\u7c7b\u6216\u59d4\u6258\u65b9\u6cd5\u3002\u00a0<\/span><\/p>\n<pre class=\"prettyprint language-default\"><code class=\"language-default\">builder.Services.AddOpenApi(options =&gt;\u00a0\r\n{\u00a0\r\n\u00a0\u00a0\u00a0 \/\/ \u6dfb\u52a0\u6587\u6863\u8f6c\u6362\u5668\u4f5c\u4e3a\u7c7b\u7684\u5b9e\u4f8b \u00a0\r\n\u00a0\u00a0\u00a0 options.AddDocumentTransformer(new MyDocumentTransformer());\u00a0\r\n\u00a0\u00a0\u00a0 \/\/ \u4ee5 DI \u6fc0\u6d3b\u7c7b\u7684\u5f62\u5f0f\u6dfb\u52a0\u64cd\u4f5c\u8f6c\u6362\u5668 \u00a0\r\n\u00a0\u00a0\u00a0 options.AddOperationTransformer&lt;MyOperationTransformer&gt;();\u00a0\r\n\u00a0\u00a0\u00a0 \/\/ \u4f5c\u4e3a\u59d4\u6258\u65b9\u6cd5\u6dfb\u52a0\u6a21\u5f0f\u8f6c\u6362\u5668 \u00a0\r\n\u00a0\u00a0\u00a0 options.AddSchemaTransformer((schema, context, cancellationToken)\u00a0\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 =&gt; Task.CompletedTask);\u00a0\r\n});\u00a0<\/code><\/pre>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u6587\u6863\u8f6c\u6362\u5668\u7684\u4e00\u79cd\u7528\u5904\u662f\u4fee\u6539 OpenAPI \u6587\u6863\u4e2d <code>paths<\/code> \u548c <code>components.schemas<\/code> \u4e4b\u5916\u7684\u90e8\u5206\u3002\u4f8b\u5982\uff0c\u60a8\u53ef\u4ee5\u5728\u6587\u6863\u7684 <code>info<\/code> \u5143\u7d20\u4e2d\u6dfb\u52a0 <code>contact<\/code>\uff0c\u5982\u4e0b\u6240\u793a\uff1a\u00a0<\/span><\/p>\n<pre class=\"prettyprint language-default\"><code class=\"language-default\">builder.Services.AddOpenApi(options =&gt;\r\n{\r\n    options.AddDocumentTransformer((document, context, cancellationToken) =&gt;\r\n    {\r\n        document.Info.Contact = new OpenApiContact\r\n        {\r\n            Name = \"Contoso Support\",\r\n            Email = \"support@contoso.com\"\r\n        };\r\n        return Task.CompletedTask;\r\n    }\r\n});<\/code><\/pre>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u64cd\u4f5c\u8f6c\u6362\u5668\u53ef\u7528\u4e8e\u4fee\u6539\u6587\u6863\u4e2d\u7684\u5355\u4e2a\u64cd\u4f5c\u3002\u64cd\u4f5c\u8f6c\u6362\u5668\u4f1a\u9488\u5bf9\u5e94\u7528\u4e2d\u7684\u6bcf\u4e2a\u64cd\u4f5c\u8c03\u7528\uff0c\u5b83\u53ef\u4ee5\u9009\u62e9\u662f\u5426\u4fee\u6539\u64cd\u4f5c\u3002\u4f8b\u5982\uff0c\u60a8\u53ef\u4ee5\u50cf\u8fd9\u6837\u4e3a\u6240\u6709\u9700\u8981\u6388\u6743\u7684\u64cd\u4f5c\u6dfb\u52a0\u4e00\u4e2a\u5b89\u5168\u6027\u8981\u6c42\uff1a\u00a0<\/span><\/p>\n<pre class=\"prettyprint language-default\"><code class=\"language-default\">    options.AddOperationTransformer((operation, context, cancellationToken) =&gt;\r\n    {\r\n        if (context.Description.ActionDescriptor.EndpointMetadata.OfType&lt;IAuthorizeData&gt;().Any())\r\n        {\r\n            operation.Security = [new() { [\"Bearer\"] = [] }];\r\n        }\r\n        return Task.CompletedTask;\r\n    });<\/code><\/pre>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u67b6\u6784\u8f6c\u6362\u5668\u53ef\u7528\u4e8e\u4fee\u6539\u5e94\u7528\u7a0b\u5e8f\u7684\u67b6\u6784\u3002\u67b6\u6784\u63cf\u8ff0\u4e86\u64cd\u4f5c\u7684\u8bf7\u6c42\u6216\u54cd\u5e94\u4f53\u3002\u8bf7\u6c42\u6216\u54cd\u5e94\u4f53\u4e2d\u7684\u590d\u6742\u5c5e\u6027\u53ef\u80fd\u5177\u6709\u5176\u81ea\u5df1\u7684\u67b6\u6784\u3002\u67b6\u6784\u8f6c\u6362\u5668\u53ef\u4ee5\u7528\u6765\u4fee\u6539\u4efb\u610f\u6216\u6240\u6709\u8fd9\u4e9b\u67b6\u6784\u3002\u00a0<\/span><\/p>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u9700\u8981\u6ce8\u610f\u7684\u662f\uff0c\u5305\u62ec\u67b6\u6784\u8f6c\u6362\u5668\u5728\u5185\u7684\u6240\u6709\u8f6c\u6362\u5668\u90fd\u4f1a\u5728\u67b6\u6784\u88ab\u8f6c\u6362\u4e3a &#8220;$ref&#8221; \u5f15\u7528\u4e4b\u524d\u88ab\u8c03\u7528\u2014\u2014\u6b64\u8fc7\u7a0b\u5c06\u5728\u4e0b\u4e00\u8282\u4e2d\u8ba8\u8bba\u3002\u00a0<\/span><\/p>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u4ee5\u4e0b\u793a\u4f8b\u5c55\u793a\u4e86\u4e00\u4e2a\u7b80\u5355\u7684\u67b6\u6784\u8f6c\u6362\u5668\uff0c\u5b83\u5c06\u4efb\u4f55\u8868\u793a C# decimal \uff08\u5341\u8fdb\u5236\uff09\u503c\u7684\u67b6\u6784\u7684 format \uff08\u683c\u5f0f\uff09\u5b57\u6bb5\u8bbe\u7f6e\u4e3a decimal\uff08\u5341\u8fdb\u5236\uff09\uff1a\u00a0<\/span><\/p>\n<pre class=\"prettyprint language-default\"><code class=\"language-default\">    options.AddSchemaTransformer((schema, context, cancellationToken) =&gt;\r\n    {\r\n        if (context.JsonTypeInfo.Type == typeof(decimal))\r\n        {\r\n            \/\/ default schema for decimal is just type: number.  Add format: decimal\r\n            schema.Format = \"decimal\";\r\n        }\r\n        return Task.CompletedTask;\r\n    });<\/code><\/pre>\n<h3><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 14pt;\"><b>\u81ea\u5b9a\u4e49\u67b6\u6784\u91cd\u7528<\/b>\u00a0<\/span><\/h3>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u5728\u6240\u6709\u8f6c\u6362\u5668\u5e94\u7528\u5b8c\u6210\u540e\uff0c\u6846\u67b6\u4f1a\u5bf9\u6587\u6863\u8fdb\u884c\u5904\u7406\uff0c\u5c06\u67d0\u4e9b\u67b6\u6784\u8f6c\u79fb\u5230 <code>components.schemas<\/code> \u90e8\u5206\uff0c\u5e76\u66ff\u6362\u4e3a\u6307\u5411\u88ab\u8f6c\u79fb\u67b6\u6784\u7684 <code>$ref<\/code> \u5f15\u7528\u3002\u8fd9\u79cd\u5904\u7406\u51cf\u5c11\u4e86\u6587\u6863\u7684\u5927\u5c0f\uff0c\u4f7f\u5176\u66f4\u6613\u4e8e\u9605\u8bfb\u3002\u00a0<\/span><\/p>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u8fd9\u4e2a\u5904\u7406\u7684\u7ec6\u8282\u6bd4\u8f83\u590d\u6742\uff0c\u5e76\u4e14\u53ef\u80fd\u4f1a\u5728\u672a\u6765\u7684 .NET \u7248\u672c\u4e2d\u53d1\u751f\u53d8\u5316\uff0c\u4f46\u603b\u4f53\u6765\u8bf4\uff1a\u00a0<\/span><\/p>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"1\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"1\" data-aria-level=\"1\"><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u5bf9\u4e8e \u7c7b\/\u8bb0\u5f55\/\u7ed3\u6784\u7c7b\u578b\u7684\u67b6\u6784\uff0c\u5982\u679c\u5b83\u4eec\u5728\u6587\u6863\u4e2d\u51fa\u73b0\u591a\u6b21\uff0c\u5219\u4f1a\u88ab\u66ff\u6362\u4e3a\u6307\u5411 <code>components.schemas<\/code> \u4e2d\u67b6\u6784\u7684 <code>$ref<\/code> \u5f15\u7528\u3002\u00a0<\/span><\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"1\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"2\" data-aria-level=\"1\"><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u5bf9\u4e8e\u539f\u59cb\u7c7b\u578b\u548c\u6807\u51c6\u96c6\u5408\u7684\u67b6\u6784\uff0c\u5219\u4fdd\u6301\u201c\u5185\u8054\u201d\u3002\u00a0<\/span><\/li>\n<\/ul>\n<ul>\n<li data-leveltext=\"\uf0b7\" data-font=\"Symbol\" data-listid=\"1\" data-list-defn-props=\"{&quot;335552541&quot;:1,&quot;335559685&quot;:720,&quot;335559991&quot;:360,&quot;469769226&quot;:&quot;Symbol&quot;,&quot;469769242&quot;:[8226],&quot;469777803&quot;:&quot;left&quot;,&quot;469777804&quot;:&quot;\uf0b7&quot;,&quot;469777815&quot;:&quot;hybridMultilevel&quot;}\" aria-setsize=\"-1\" data-aria-posinset=\"3\" data-aria-level=\"1\"><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u5bf9\u4e8e\u679a\u4e3e\u7c7b\u578b\u7684\u67b6\u6784\uff0c\u603b\u662f\u4f1a\u88ab\u66ff\u6362\u4e3a\u6307\u5411 <code>components.schemas<\/code> \u4e2d\u67b6\u6784\u7684 <code>$ref<\/code> \u5f15\u7528\u3002\u00a0<\/span><\/li>\n<\/ul>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u901a\u5e38\u60c5\u51b5\u4e0b\uff0c<code>components.schemas<\/code> \u4e2d\u7684\u67b6\u6784\u540d\u79f0\u662f\u7c7b\/\u8bb0\u5f55\/\u7ed3\u6784\u7c7b\u578b\u7684\u540d\u79f0\uff0c\u4f46\u5728\u67d0\u4e9b\u60c5\u51b5\u4e0b\u53ef\u80fd\u9700\u8981\u4f7f\u7528\u5176\u4ed6\u540d\u79f0\u3002\u00a0<\/span><\/p>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">ASP.NET Core \u5141\u8bb8\u60a8\u901a\u8fc7\u914d\u7f6e <code>OpenApiOptions<\/code> \u7684 <code>CreateSchemaReferenceId<\/code> \u5c5e\u6027\u81ea\u5b9a\u4e49\u54ea\u4e9b\u67b6\u6784\u4f1a\u88ab\u66ff\u6362\u4e3a\u6307\u5411 <code>components.schemas<\/code> \u4e2d\u67b6\u6784\u7684 <code>$ref<\/code> \u5f15\u7528\u3002\u6b64\u5c5e\u6027\u662f\u4e00\u4e2a\u59d4\u6258\uff0c\u5b83\u63a5\u53d7 <code>JsonTypeInfo<\/code> \u5bf9\u8c61\u5e76\u8fd4\u56de <code>components.schemas<\/code> \u4e2d\u5e94\u7528\u4e8e\u8be5\u7c7b\u578b\u7684\u67b6\u6784\u7684\u540d\u79f0\u3002\u6846\u67b6\u63d0\u4f9b\u4e86\u6b64\u59d4\u6258\u7684\u9ed8\u8ba4\u5b9e\u73b0 <code>OpenApiOptions.CreateDefaultSchemaReferenceId<\/code>\uff0c\u5b83\u4f7f\u7528\u4e86\u7c7b\u578b\u7684\u540d\u79f0\uff0c\u4f46\u60a8\u4e5f\u53ef\u4ee5\u7528\u81ea\u5df1\u7684\u5b9e\u73b0\u6765\u4ee3\u66ff\u5b83\u3002\u00a0<\/span><\/p>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u4e3e\u4e2a\u7b80\u5355\u7684\u81ea\u5b9a\u4e49\u4f8b\u5b50\uff0c\u60a8\u53ef\u4ee5\u9009\u62e9\u59cb\u7ec8\u5185\u8054\u679a\u4e3e\u6a21\u5f0f\u3002\u8fd9\u53ef\u4ee5\u901a\u8fc7\u5c06 <code>CreateSchemaReferenceId<\/code> \u8bbe\u7f6e\u4e3a\u4e00\u4e2a\u59d4\u6258\u5b9e\u73b0\u6765\u5b9e\u73b0\uff0c\u8be5\u59d4\u6258\u5bf9\u679a\u4e3e\u7c7b\u578b\u59cb\u7ec8\u8fd4\u56de <code>null<\/code>\uff0c\u800c\u5bf9\u5176\u4ed6\u7c7b\u578b\u5219\u8fd4\u56de\u9ed8\u8ba4\u5b9e\u73b0\u7684\u503c\u3002\u4ee5\u4e0b\u4ee3\u7801\u5c55\u793a\u4e86\u5982\u4f55\u5b8c\u6210\u6b64\u64cd\u4f5c\uff1a\u00a0<\/span><\/p>\n<pre class=\"prettyprint language-default\"><code class=\"language-default\">builder.Services.AddOpenApi(options =&gt;\r\n{\r\n    \/\/ Always inline enum schemas\r\n    options.CreateSchemaReferenceId = (type) =&gt; type.Type.IsEnum ? null : OpenApiOptions.CreateDefaultSchemaReferenceId(type);\r\n});<\/code><\/pre>\n<h3><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 14pt;\"><b>\u5728\u6784\u5efa\u65f6\u751f\u6210 OpenAPI \u6587\u6863<\/b>\u00a0<\/span><\/h3>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u6211\u60f3\u8bb8\u591a .NET \u5f00\u53d1\u4eba\u5458\u90fd\u4f1a\u53d1\u73b0\uff0c\u5728\u6784\u5efa\u65f6\u751f\u6210 OpenAPI \u6587\u6863\u7684\u9009\u9879\u662f\u4e00\u9879\u975e\u5e38\u5438\u5f15\u4eba\u7684\u529f\u80fd\u3002\u5c06 OpenAPI \u6587\u6863\u7684\u751f\u6210\u4f5c\u4e3a\u6784\u5efa\u8fc7\u7a0b\u7684\u4e00\u90e8\u5206\uff0c\u53ef\u4ee5\u66f4\u8f7b\u677e\u5730\u4e0e\u672c\u5730\u5f00\u53d1\u5de5\u4f5c\u6d41\u6216 CI \u7ba1\u9053\u4e2d\u7684\u5de5\u5177\u96c6\u6210\u3002\u4f8b\u5982\uff0c\u60a8\u53ef\u4ee5\u5bf9\u751f\u6210\u7684\u6587\u6863\u8fd0\u884c linter \uff08\u68c0\u9a8c\u7a0b\u5e8f\uff09\u4ee5\u786e\u4fdd\u5176\u7b26\u5408\u7ec4\u7ec7\u7684\u6807\u51c6\uff0c\u6216\u8005\u4f7f\u7528\u8be5\u6587\u6863\u751f\u6210\u5ba2\u6237\u7aef\u4ee3\u7801\u6216\u6d4b\u8bd5\u3002\u00a0<\/span><\/p>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u5728\u6784\u5efa\u65f6\u751f\u6210 OpenAPI \u6587\u6863\u975e\u5e38\u7b80\u5355\u3002\u53ea\u9700\u5c06 <code>Microsoft.Extensions.ApiDescription.Server<\/code> \u5305\u6dfb\u52a0\u5230\u60a8\u7684\u9879\u76ee\u4e2d\u3002\u9ed8\u8ba4\u60c5\u51b5\u4e0b\uff0cOpenAPI \u6587\u6863\u4f1a\u751f\u6210\u5230\u9879\u76ee\u7684 obj \u76ee\u5f55\u4e2d\uff0c\u4f46\u60a8\u53ef\u4ee5\u901a\u8fc7 <code>OpenApiDocumentsDirectory<\/code> \u5c5e\u6027\u81ea\u5b9a\u4e49\u751f\u6210\u6587\u6863\u7684\u4f4d\u7f6e\u3002\u4f8b\u5982\uff0c\u8981\u5c06\u6587\u6863\u751f\u6210\u5230\u9879\u76ee\u7684\u6839\u76ee\u5f55\uff0c\u53ef\u4ee5\u5728\u9879\u76ee\u6587\u4ef6\u4e2d\u6dfb\u52a0\u4ee5\u4e0b\u5185\u5bb9\uff1a\u00a0<\/span><\/p>\n<pre class=\"prettyprint language-default\"><code class=\"language-default\">&lt;PropertyGroup&gt;\r\n  &lt;OpenApiDocumentsDirectory&gt;.\/&lt;\/OpenApiDocumentsDirectory&gt;\r\n&lt;\/PropertyGroup&gt;<\/code><\/pre>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u8bf7\u6ce8\u610f\uff0c\u6784\u5efa\u65f6\u751f\u6210 OpenAPI \u6587\u6863\u7684\u673a\u5236\u662f\u901a\u8fc7\u542f\u52a8\u5e94\u7528\u7a0b\u5e8f\u7684\u5165\u53e3\u70b9\u5e76\u4f7f\u7528\u60f0\u6027\u670d\u52a1\u5668\u5b9e\u73b0\u6765\u5b8c\u6210\u7684\u3002\u8fd9\u5141\u8bb8\u6846\u67b6\u7eb3\u5165\u4ec5\u5728\u8fd0\u884c\u65f6\u53ef\u7528\u7684\u5143\u6570\u636e\uff0c\u4f46\u5728\u67d0\u4e9b\u6784\u5efa\u573a\u666f\u4e0b\uff0c\u53ef\u80fd\u9700\u8981\u5bf9\u60a8\u7684\u5e94\u7528\u7a0b\u5e8f\u8fdb\u884c\u4e00\u4e9b\u66f4\u6539\u4ee5\u786e\u4fdd\u6b63\u5e38\u5de5\u4f5c\u3002\u00a0<\/span><\/p>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u6709\u5173\u66f4\u591a\u4fe1\u606f\uff0c\u8bf7\u53c2\u9605\u6587\u6863\u4e2d\u7684<a href=\"https:\/\/learn.microsoft.com\/aspnet\/core\/fundamentals\/openapi\/aspnetcore-openapi?view=aspnetcore-9.0#generate-openapi-documents-at-build-time\">\u6784\u5efa\u65f6\u751f\u6210 OpenAPI<\/a>\u4e3b\u9898\u3002\u00a0<\/span><\/p>\n<h2><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 18pt;\"><b>\u603b\u7ed3<\/b>\u00a0<\/span><\/h2>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">.NET 9 \u4e2d\u65b0\u7684 OpenAPI \u6587\u6863\u751f\u6210\u529f\u4e3a\u5f00\u53d1\u4eba\u5458\u521b\u5efa\u548c\u7ef4\u62a4 ASP.NET \u5e94\u7528\u7a0b\u5e8f\u7684 API \u6587\u6863\u63d0\u4f9b\u4e86\u65b0\u7684\u9014\u5f84\u3002\u901a\u8fc7\u5c06\u6b64\u529f\u80fd\u76f4\u63a5\u96c6\u6210\u5230 ASP.NET Core \u4e2d\uff0c\u5f00\u53d1\u4eba\u5458\u73b0\u5728\u53ef\u4ee5\u5728\u6784\u5efa\u65f6\u6216\u8fd0\u884c\u65f6\u751f\u6210 OpenAPI \u6587\u6863\uff0c\u6839\u636e\u9700\u8981\u81ea\u5b9a\u4e49\u5b83\u4eec\uff0c\u5e76\u786e\u4fdd\u5b83\u4eec\u4e0e\u4ee3\u7801\u4fdd\u6301\u540c\u6b65\u3002\u800c\u4e14\uff0c\u5728Minimal API \u5e94\u7528\u7a0b\u5e8f\u4e2d\uff0c\u6b64\u529f\u80fd\u4e0e\u539f\u751f AoT \u7f16\u8bd1\u5b8c\u5168\u517c\u5bb9\u3002\u00a0<\/span><\/p>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u6211\u4eec\u5f88\u4e50\u610f\u542c\u5230\u60a8\u5bf9\u6b64\u65b0\u529f\u80fd\u7684\u53cd\u9988\u3002\u8bf7\u8bd5\u7528\u5e76\u544a\u8bc9\u6211\u4eec\u60a8\u7684\u60f3\u6cd5\u3002\u00a0<\/span><\/p>\n<p><span style=\"font-family: tahoma, arial, helvetica, sans-serif; font-size: 12pt;\">\u795d\u60a8\u7f16\u7801\u6109\u5feb\uff01\u00a0<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u672c\u6587\u7ffb\u8bd1\u81eaMike Kistler\u7684OpenAPI document generation in .NET 9 .NET 9 \u4e2d\u7684 ASP.NET Core \u901a\u8fc7\u5f15\u5165\u5168\u65b0\u7684\u5bf9OpenAPI \u6587\u6863\u751f\u6210\u529f\u80fd\u7684\u5185\u7f6e\u652f\u6301\uff0c\u7b80\u5316\u4e86\u4e3a API \u7aef\u70b9\u521b\u5efa OpenAPI \u6587\u6863\u7684\u8fc7\u7a0b\u3002\u8fd9\u9879\u65b0\u529f\u80fd\u65e8\u5728\u7b80\u5316\u5f00\u53d1\u5de5\u4f5c\u6d41\u7a0b\uff0c\u5e76\u6539\u5584 OpenAPI \u5b9a\u4e49\u5728 ASP.NET \u5e94\u7528\u4e2d\u7684\u96c6\u6210\u3002 OpenAPI \u7684\u5e7f\u6cdb\u4f7f\u7528\u50ac\u751f\u4e86\u4e30\u5bcc\u7684\u5de5\u5177\u548c\u670d\u52a1\u751f\u6001\u7cfb\u7edf\uff0c\u5b83\u4eec\u80fd\u591f\u5e2e\u52a9\u60a8\u66f4\u9ad8\u6548\u5730\u6784\u5efa\u3001\u6d4b\u8bd5\u548c\u8bb0\u5f55 API\u3002\u4f8b\u5982\uff0cSwagger UI\u3001Kiota \u5ba2\u6237\u7aef\u5e93\u751f\u6210\u5668\u548c Redoc \u7b49\uff0c\u5f53\u7136\u8fd8\u6709\u8bb8\u591a\u5176\u4ed6\u5de5\u5177\u3002\u00a0 \u4e3a\u4ec0\u4e48\u9009\u62e9 OpenAPI\uff1f\u00a0 OpenAPI \u662f\u5b9a\u4e49\u548c\u8bb0\u5f55 HTTP API \u7684\u5f3a\u5927\u5de5\u5177\u3002\u5b83\u63d0\u4f9b\u4e86\u4e00\u79cd\u6807\u51c6\u5316\u65b9\u5f0f\u6765\u63cf\u8ff0 API \u7684\u7aef\u70b9\u3001\u8bf7\u6c42\u548c\u54cd\u5e94\u683c\u5f0f\u3001\u8eab\u4efd\u9a8c\u8bc1\u65b9\u6848\u4ee5\u53ca\u5176\u4ed6\u91cd\u8981\u7ec6\u8282\u3002\u8fd9\u79cd\u6807\u51c6\u5316\u4f7f\u5f00\u53d1\u4eba\u5458\u80fd\u591f\u66f4\u8f7b\u677e\u5730\u4e86\u89e3\u548c\u4e0eAPI\u8fdb\u884c\u4ea4\u4e92\uff0c\u4ece\u800c\u4fc3\u8fdb\u66f4\u597d\u7684\u534f\u4f5c\u5e76\u6784\u5efa\u66f4\u5f3a\u5927\u7684\u5e94\u7528\u7a0b\u5e8f\u3002\u00a0 \u6b64\u5916\uff0c\u8bb8\u591a\u5927\u578b\u8bed\u8a00\u6a21\u578b\uff08LLMs\uff09\u5df2\u5728 OpenAPI \u6587\u6863\u4e0a\u8fdb\u884c\u4e86\u8bad\u7ec3\uff0c\u4f7f\u5176\u80fd\u591f\u81ea\u52a8\u751f\u6210\u4ee3\u7801\u3001\u6d4b\u8bd5\u7528\u4f8b\u548c\u5176\u4ed6\u5de5\u4ef6\u3002\u901a\u8fc7\u4e3a\u60a8\u7684 API \u751f\u6210 OpenAPI \u6587\u6863\uff0c\u60a8\u53ef\u4ee5\u5229\u7528\u8fd9\u4e9b LLM \u6765\u52a0\u901f\u5f00\u53d1\u6d41\u7a0b\u3002\u00a0 .NET 9 \u4e2d\u7684\u65b0\u529f\u80fd\uff1f\u00a0 \u5728 .NET 9 \u4e2d\uff0c\u6211\u4eec\u5f15\u5165\u4e86\u5bf9 OpenAPI [&hellip;]<\/p>\n","protected":false},"author":177361,"featured_media":994,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[59,1,61],"tags":[52,75,76],"class_list":["post-983","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-net","category-dotnet-ch","category-asp-net-core","tag-net-9","tag-api","tag-openapi"],"acf":[],"blog_post_summary":"<p>\u672c\u6587\u7ffb\u8bd1\u81eaMike Kistler\u7684OpenAPI document generation in .NET 9 .NET 9 \u4e2d\u7684 ASP.NET Core \u901a\u8fc7\u5f15\u5165\u5168\u65b0\u7684\u5bf9OpenAPI \u6587\u6863\u751f\u6210\u529f\u80fd\u7684\u5185\u7f6e\u652f\u6301\uff0c\u7b80\u5316\u4e86\u4e3a API \u7aef\u70b9\u521b\u5efa OpenAPI \u6587\u6863\u7684\u8fc7\u7a0b\u3002\u8fd9\u9879\u65b0\u529f\u80fd\u65e8\u5728\u7b80\u5316\u5f00\u53d1\u5de5\u4f5c\u6d41\u7a0b\uff0c\u5e76\u6539\u5584 OpenAPI \u5b9a\u4e49\u5728 ASP.NET \u5e94\u7528\u4e2d\u7684\u96c6\u6210\u3002 OpenAPI \u7684\u5e7f\u6cdb\u4f7f\u7528\u50ac\u751f\u4e86\u4e30\u5bcc\u7684\u5de5\u5177\u548c\u670d\u52a1\u751f\u6001\u7cfb\u7edf\uff0c\u5b83\u4eec\u80fd\u591f\u5e2e\u52a9\u60a8\u66f4\u9ad8\u6548\u5730\u6784\u5efa\u3001\u6d4b\u8bd5\u548c\u8bb0\u5f55 API\u3002\u4f8b\u5982\uff0cSwagger UI\u3001Kiota \u5ba2\u6237\u7aef\u5e93\u751f\u6210\u5668\u548c Redoc \u7b49\uff0c\u5f53\u7136\u8fd8\u6709\u8bb8\u591a\u5176\u4ed6\u5de5\u5177\u3002\u00a0 \u4e3a\u4ec0\u4e48\u9009\u62e9 OpenAPI\uff1f\u00a0 OpenAPI \u662f\u5b9a\u4e49\u548c\u8bb0\u5f55 HTTP API \u7684\u5f3a\u5927\u5de5\u5177\u3002\u5b83\u63d0\u4f9b\u4e86\u4e00\u79cd\u6807\u51c6\u5316\u65b9\u5f0f\u6765\u63cf\u8ff0 API \u7684\u7aef\u70b9\u3001\u8bf7\u6c42\u548c\u54cd\u5e94\u683c\u5f0f\u3001\u8eab\u4efd\u9a8c\u8bc1\u65b9\u6848\u4ee5\u53ca\u5176\u4ed6\u91cd\u8981\u7ec6\u8282\u3002\u8fd9\u79cd\u6807\u51c6\u5316\u4f7f\u5f00\u53d1\u4eba\u5458\u80fd\u591f\u66f4\u8f7b\u677e\u5730\u4e86\u89e3\u548c\u4e0eAPI\u8fdb\u884c\u4ea4\u4e92\uff0c\u4ece\u800c\u4fc3\u8fdb\u66f4\u597d\u7684\u534f\u4f5c\u5e76\u6784\u5efa\u66f4\u5f3a\u5927\u7684\u5e94\u7528\u7a0b\u5e8f\u3002\u00a0 \u6b64\u5916\uff0c\u8bb8\u591a\u5927\u578b\u8bed\u8a00\u6a21\u578b\uff08LLMs\uff09\u5df2\u5728 OpenAPI \u6587\u6863\u4e0a\u8fdb\u884c\u4e86\u8bad\u7ec3\uff0c\u4f7f\u5176\u80fd\u591f\u81ea\u52a8\u751f\u6210\u4ee3\u7801\u3001\u6d4b\u8bd5\u7528\u4f8b\u548c\u5176\u4ed6\u5de5\u4ef6\u3002\u901a\u8fc7\u4e3a\u60a8\u7684 API \u751f\u6210 OpenAPI \u6587\u6863\uff0c\u60a8\u53ef\u4ee5\u5229\u7528\u8fd9\u4e9b LLM \u6765\u52a0\u901f\u5f00\u53d1\u6d41\u7a0b\u3002\u00a0 .NET 9 \u4e2d\u7684\u65b0\u529f\u80fd\uff1f\u00a0 \u5728 .NET 9 \u4e2d\uff0c\u6211\u4eec\u5f15\u5165\u4e86\u5bf9 OpenAPI [&hellip;]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet-ch\/wp-json\/wp\/v2\/posts\/983","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet-ch\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet-ch\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet-ch\/wp-json\/wp\/v2\/users\/177361"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet-ch\/wp-json\/wp\/v2\/comments?post=983"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/dotnet-ch\/wp-json\/wp\/v2\/posts\/983\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet-ch\/wp-json\/wp\/v2\/media\/994"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/dotnet-ch\/wp-json\/wp\/v2\/media?parent=983"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet-ch\/wp-json\/wp\/v2\/categories?post=983"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/dotnet-ch\/wp-json\/wp\/v2\/tags?post=983"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}