Swagger/Swashbuckle授权。默认选中的作用域
Swagger/Swashbuckle授权是一种用于API文档生成和测试的工具。它可以帮助开发人员自动生成API文档，并提供一个交互式的界面来测试API的各种功能。
Swagger是一种开放源代码的规范，用于描述和定义RESTful风格的API。它提供了一种标准的方式来描述API的端点、参数、请求和响应等信息。Swagger可以生成可读性强的API文档，使开发人员和用户能够更好地理解和使用API。
Swashbuckle是Swagger的一个.NET实现，它可以与ASP.NET Web API一起使用。Swashbuckle可以通过读取API代码中的注释和属性来自动生成Swagger文档。它还提供了一个UI界面，可以在浏览器中直接测试API的各种功能。
授权是指在使用API时进行身份验证和权限验证的过程。Swagger/Swashbuckle授权可以帮助开发人员在API文档中定义和配置授权机制。通过Swagger/Swashbuckle授权，开发人员可以为API的不同端点和操作设置不同的授权要求，例如基于角色的访问控制、OAuth2授权等。
对于Swagger/Swashbuckle授权的应用场景，可以是任何需要提供API文档和测试功能的项目。它可以帮助开发人员更好地管理和维护API，提高开发效率和代码质量。
腾讯云提供了一系列与API开发和管理相关的产品和服务，可以与Swagger/Swashbuckle授权结合使用。其中，腾讯云API网关（API Gateway）可以帮助开发人员快速构建和部署API，并提供灵活的授权和访问控制功能。您可以通过腾讯云API网关的官方文档了解更多信息：腾讯云API网关
请注意，本回答中没有提及其他云计算品牌商，如有需要，您可以自行搜索相关信息。
相关·内容
我有一个运行webapi (XML4.5)的帮助页面，通过ApiExplorer加载我所有的.net注释。我现在想通过swashbuckle添加swagger。所以我安装了swashbuckle，但是当我浏览到我的端点时，我得到了一个错误，正如swashbuckle文档所建议的那样。
终结点: localhost:1234/api/company/swagger错误：{“Message”：“未授权的请求”}或终结点: localhost:1234/api/company/swagger/apidocs错误: 404 -未找到
我是不是错过了一步，或者我做错了什么？？
浏览 1提问于2014-07-25得票数 1
我目前正在使用Swashbuckle来记录我的.Net API，这是一个很好的工具。我想知道是否可以在我的项目中添加更多的swagger文件。
我从swashbuckle文档中看到了以下代码，并尝试了这一点，但它似乎不起作用：
.EnableSwagger("docs/{apiVersion}/swagger", c => c.SingleApiVersion("v1", "A title for your API"))
.EnableSwaggerUi("sandbox/{*assetPath}");
总体目标是必
浏览 1提问于2016-09-29得票数 1
回答已采纳
我试图在一个叫TablesReachApi的项目中实现身份服务器(LoaclAuthentication)和swagger定义。
我添加了一些测试UserController，并实现了swashbuckle，这没问题，但我在设置swagger授权以及从权威机构获取令牌时遇到了问题。
下面是代码：
当我尝试使用自动用户名和密码调用http://localhost:5001/connect/token时: client:secret，并且在正文中我检查了x-www-form-urlencoded -> grant_type: client_credentials，scope: TablesR
浏览 3提问于2021-03-26得票数 0
我正在用.NET Core3.0开发一些Web API，并希望将其与SwashBuckle.Swagger集成。它工作得很好，但是当我添加JWT身份验证时，它并不像我期望的那样工作。为此，我添加了以下代码： services.AddSwaggerGen(c =>
{
c.SwaggerDoc("v1", new Microsoft.OpenApi.Models.OpenApiInfo { Title = "My Web API", Version = "v1" });
c.AddSecurityDe
浏览 206提问于2019-10-01得票数 49
回答已采纳
我为API键向Swagger添加了一个header参数，这可以提供输入API键的能力。我使用以下方法
Swashbuckle.AspNetCore 6.1Swashbuckle.AspNetCore.Swagger 6.1Swashbuckle.AspNetCore.SwaggerGen 6.1Swashbuckle.AspNetCore.SwaggerUI 6.1
我的代码如下所示:在Startup.cs中添加Swagger配置的位置如下
public void ConfigureServices(IServiceCollection services)
浏览 0提问于2021-03-22得票数 0
我通过Swashbuckle V4使用Swagger，通过使用API密钥对端点进行了验证。
在使用Swashbuckle V4时，以下配置工作得很好(请注意，只显示了Swagger代码)：
public void ConfigureServices(IServiceCollection services) {
services.AddSwaggerGen(c => {
c.SwaggerDoc(
"v1",
new Info {
Title = "OAPI", Version = "v1"
});
c.
浏览 0提问于2019-07-11得票数 3
我试图将Azure管理配置为使用版本控制，并让它与Swashbuckle生成的Swagger / Open文档一起工作。
我有一个有两个版本的API -- 1.0和2.0。我已经配置了Swashbuckle来生成两个独立的Swagger文档，每个版本一个。一切都很好。
版本控制方案是按路径进行的，因此使用者需要调用正确的路径(v1.0或v2.0)。就像这样：
我在Azure管理中定义了这两个版本，并导入了这两个文档。
问题是Azure管理将路径添加到基本URL，然后由于Swashbuckle生成的Open文档中定义的路径，我在Azure管理中使用了。
下面是生成的Swagger / Open
浏览 0提问于2018-10-16得票数 1
回答已采纳
我正在尝试将Swagger (通过Swashbuckle 5.6.0)添加到.Net 4.5.1 WebAPI中。
直到我在下面的中通过新的AdminController.cs属性遇到一个自定义授权筛选器，我才能让事情正常工作
public class AdminController : BaseApiController
{
[CustomAuthorize( )]
[HttpGet]
public GenericResponse ClearCache()
{
using (var businessAccess = IoCContainer.R
浏览 0提问于2019-09-05得票数 0
回答已采纳
在我在StartUp类中添加授权策略之前，Swagger一切都很好：
options.AddPolicy("requiredRoleType", policy => policy.RequireRole());
问题: Swagger是无法访问的，因为这个策略。我尝试以不同的顺序移动services.AddSwaggerGen，但问题仍然存在。
无论如何，让Swagger绕过授权策略？
(使用.NET 5.0和Swashbuckle.AspNetCore 6.0.7)
浏览 0提问于2021-02-26得票数 0
我最近完成了从斯瓦什巴克尔到的转变。在进行更改后，我遇到的一个问题是，现在我无法调用我的API，这需要在授权头中发送一个令牌。下面是我以前在Swashbuckle和现在的Swagger-Net中使用SwaggerConfig.cs代码的方式
Swashbuckle
//section for .EnableSwagger
c.ApiKey("apiKey")
.Description("API Key Authentication")
.Name("Authorization")
.In("header");
//section
浏览 1提问于2018-09-20得票数 4
回答已采纳
我想删除授权，也就是删除我的web应用程序的持有者令牌身份验证，对于swagger alone.And授权应该像对postman.If这样的其他控制台应用程序一样工作，那么如何在swagger alone.Provided上实现这一点我在我的应用程序中使用了swashbuckle nuget包。
浏览 0提问于2018-03-26得票数 0
目前，.net核心的swashbuckle中的授权头有一个问题，每个端点上的第一行代码是：
string auth = Request.Headers["Authorization"];
使用postman时，一切工作正常，但从localhost/swagger发出请求时，标头为空
插入断点时，标头为空值。
当从端点删除授权时，请求的正文是正确的，并且一切都正常工作
在我的services.AddSwaggerGen中，我添加了安全定义：
services.AddSwaggerGen(c =>
{
c.SwaggerDoc(&
浏览 4提问于2018-04-19得票数 0
我们有一个api web应用程序，它使用swagger/swashbuckle来编写asp.net文档。该api由azure AD使用oauth/openid-connect进行保护。swagger的配置是在代码中完成的：
var oauthParams = new Dictionary<string, string>
{
{ "resource", "https://blahblahblah/someId" }
};
GlobalConfiguration.C
浏览 0提问于2017-10-26得票数 0
我们有一个相当大的ASP.NET样板.NET Core3.1项目，而Swashbuckle在生成Swagger JSON时似乎耗尽了内存。 我们会遇到以下错误： RequestAborted: Exception of type 'System.OutOfMemoryException' was thrown.. Request Path: /swagger/v1/swagger.json
System.OutOfMemoryException: Exception of type 'System.OutOfMemoryException' was throw
浏览 24提问于2021-09-14得票数 1
回答已采纳
我需要配置Swashbuckle以在OpenAPI 2.0版本中生成Swagger规范。我在startup.cs中使用以下代码完成此操作：
public void Configure(IApplicationBuilder application, IWebHostEnvironment environment)
{
application.UseSwagger(c =>
{
c.SerializeAsV2 = true;
浏览 6提问于2021-09-20得票数 0
我们有使用Swagger的.net核心2.1MVC webapi项目。我们使用以下包：
<PackageReference Include="Swashbuckle.AspNetCore" Version="3.0.0" />
<PackageReference Include="Swashbuckle.AspNetCore.Annotations" Version="3.0.0" />
<PackageReference Include="Swashbuckle.AspNetCore.Fil
浏览 1提问于2019-05-31得票数 7
我有一个authorization 3应用程序，它实现了一个REST，并使用一个ASP.NET承载令牌进行授权，以及Swagger (Swashbuckle)。
我的控制器上有授权过滤器，比如：
[ApiController]
[Route("api/[controller]")]
[Authorize]
public class MyController : ControllerBase
{
}
Swagger与我的API一起工作，我可以生成一个JWT令牌并提供给Swagger，这一切都很好。
但是，如果我尝试使用Swagger来访问一个没有JWT令牌或无效JWT令牌的RES
浏览 2提问于2020-04-10得票数 6
我有一个ASP.NET核心Web与Swagger集成使用Swashbuckle。我已经成功地使用操作过滤器在Swagger上集成了授权，因为我不想显示匿名API的挂锁。
.OperationFilter<AuthorizeFilter>()
在过滤器中，我已经注册了Swagger的基本安全要求。
我的问题是，即使在Swagger上的API中正在进行身份验证，我也不再看到当单击挂锁图标时出现的好的身份验证弹出。
有人能回答吗，为什么我现在没有看到自动弹出？
浏览 4提问于2021-06-27得票数 3
回答已采纳
我在我的项目中使用了swashbuckle.core。下面是SwaggerConfig.cs：
using System.Web.Http;
using Swashbuckle.Application;
using WebActivator;
using System.Collections.Generic;
using System;
using Swashbuckle.Swagger;
using System.Web.Http.Description;
using System.Linq;
using System.
浏览 15提问于2018-09-05得票数 1
回答已采纳
4回答
我有一个ASP.NET Web 2应用程序。我给它添加了Swashbuckle (.NET的Swagger)。它显示我的端点没有问题，但为了发送请求，我需要向该请求附加一个授权头。如果我理解正确，为了做到这一点，我需要修改index.html文件()，因此我要克隆index.html项目，以修改index.html并添加一些头文件。
这是在Swashbuckle中发送带有请求的授权头的唯一方法吗？
浏览 7提问于2015-05-20得票数 20
回答已采纳
我正在使用Swagger测试Asp.Net核心应用程序中的API。我通过输入类似于这个Authorization: Bearer {token}的令牌来发送请求。但是授权头不是在请求中发送的。
Asp.Net核心版本3.1和Swashbuckle.AspNetCore 5.4.1
Startup.cs代码：
public class Startup
{
private const string _apiVersion = "v1";
public Startup(IConfiguration configuration)
{
Config
浏览 3提问于2020-05-29得票数 6
回答已采纳
更新2:如果更改控制器授权标记，则为
[Authorize]
到这个
[Authorize(Roles = "Read")]
然后，我得到范围选择的复选框，ajax令牌请求包含正确的范围并成功完成。不过，我还是有一个红色的感叹号。看起来像是Swagger或Swashbuckle要求角色与范围定义匹配吗？在使用Swashbuckle时，是否可以使用没有定义角色的应用程序流？如果是这样的话，如何使其工作呢？，我必须手动设置操作筛选器类中的作用域吗？如果不能在授权标记中列出角色，就不可能使用Swashbuckle，那么我需要知道如何在IdentityServer3中分配客户端角色。
浏览 2提问于2016-09-27得票数 2
回答已采纳
使用Web和使用swashbuckle生成swagger文档，我在两个不同的名称空间中定义了两个同名的不同类。当我在浏览器中打开“傲慢”页面时，上面写着：
冲突schemaIds:为A和B类型检测到的重复schemaIds -参见配置设置- "UseFullTypeNameInSchemaIds“作为潜在的解决方法
全文：
500：{“消息”：“发生了错误。”，“ExceptionMessage”：“冲突schemaIds:为类型A和B检测到的重复schemaIds”参见配置设置- \"UseFullTypeNameInSchemaIds\“用于潜在的解决办法，“Sw
浏览 9提问于2017-09-06得票数 100
回答已采纳
我有两个不同的项目：
Auth项目:该项目实现IdentityServer4作为服务API项目提供身份验证:它实现Swashbuckle.AspNetCore 5.5以生成Swagger UI
我在API项目中使用SecuritySchemeType.OpenIdConnect作为一个安全方案，每当我单击授权按钮时，我都会得到一个空的授权模式。我认为问题是因为Swagger中不支持OpenIDConnect发现。所以，我想知道是否有人能找到解决这个问题的办法。
下面是一个公开的问题，准确地解释我的问题：
浏览 5提问于2020-06-20得票数 2
我正在将一个Web从.NET框架迁移到ASP.NET内核，该API具有使用Swashbuckle生成的Swagger文档。在新的AspNetCore版本中，我使用的是Swashbuckle.AspNetCore v5.0.0-rc2。
这是一个内部服务，身份验证使用自定义HTTP报头中提供的API密钥。在.NET框架应用程序中，我将配置为启用API密钥，如下所示：
c.ApiKey("apiKey")
.Description("My description")
.Name("MyHttpHeaderName")
.In(
浏览 0提问于2019-09-15得票数 9
回答已采纳
1回答
在一个.Net核心web API中，我使用Swashbuckle集成了Swagger。API是受保护的，因此在Swagger UI中执行某些请求之前，用户需要进行授权和登录。这一切都很好用。 现在，一个API调用创建一个预签名的URL，并向文件服务器返回一个HTTP重定向(预签名的URL)。 问题是Swagger UI将带有JWT令牌的授权头发送到文件服务器(MinIO)。这会导致文件服务器接收两种不同的身份验证机制，并以无效请求作为响应。 有没有办法影响Swagger UI处理重定向的方式，或者不在重定向上发送令牌？
浏览 27提问于2019-06-13得票数 3
回答已采纳
在.NET核心项目中，我添加了一个安全定义(底部的代码)，它向页面添加了一个授权按钮，用户可以输入api -一切正常。
是否可以在URL中指定api键，这样Swagger就可以自动使用它而不必输入它？比如/swagger/index.html?authorization=0123456789之类的。
现行守则：
services.AddSwaggerGen(c => {
...
c.AddSecurityDefinition("api key", new ApiKeyScheme() {
Description = "Authorization
浏览 2提问于2019-12-12得票数 1
回答已采纳
1回答
我在我的web项目中使用Swashbuckle包，我试图用这个替换默认的Swagger
但我一直收到这条错误信息
<?xml version="1.0" encoding="ISO-8859-1"?>
<Error>
<Message>An error has occurred.</Message>
<ExceptionMessage>Embedded resource not found - ReportsAPI.swagger-ui.Index.html</ExceptionMessage&g
浏览 0提问于2019-05-09得票数 0
回答已采纳
services.AddSwaggerGen(x =>
{
});
我探索了AddSwaggerGen() NuGet Swashbuckle.AspNetCore的方法。不幸的是，我还没有找到使用已经生成的开放API规范文件的path的方法。
我的API与.net核心中的文件上传有关，我已经编写了swagger规范文件swagger.yaml，它在中运行良好。有谁可以帮我？如何将生成的开放式API规范文件注入到SwaggerUI中，并将其与.net核中的NuGet Swashbuckle.AspNetCore一起使用
app.UseSwaggerUI(
浏览 3提问于2021-04-27得票数 1
我在WebApi 5中有一个.Net项目，并且已经在使用Swagger与默认设置( ConfigureServices方法中的services.AddSwaggerGen()& app.UseSwagger()和app.UseSwaggerUI()在Startup.cs中的配置方法)，没有任何问题。
现在我决定通过Swashbuckle.AspNetCore.Cli创建Swagger文件。我创建了清单文件：.net new tool-manifest
然后安装Swashbuckle.AspNetCore.Cli:dotnet tool install --version 6.2.3 S
浏览 12提问于2022-01-05得票数 2
我已经为我的asp.net核心项目包括了swagger package(Swashbuckle.AspNetCore)。swagger包是最新的4.0.1版本。我尝试使用以下代码在swagger ui中启用“授权”按钮：
// Register the Swagger generator
services.AddSwaggerGen(c =>
{
c.SwaggerDoc("v1", new Info { Title = "Sample API", Description = "Swagger Sample API", Versio
浏览 1提问于2018-12-11得票数 0
回答已采纳
1回答
我在使用.net核心样板框架的swagger中得到了以下错误。我在'Startup.cs‘中做了必要的配置。我在项目中加入了Swagger。Swashbuckle.AspNetCore包版本:5.5.1如何解决此问题？ InvalidOperationException:尝试调用中间件'Swashbuckle.AspNetCore.Swagger.SwaggerMiddleware'.时无法解析类型'Swashbuckle.AspNetCore.Swagger.ISwaggerProvider‘的服务
浏览 18提问于2021-07-07得票数 0
目前，我正在尝试将一个项目从dotnet 2.1更新到3.1。为了做到这一点并避免异常，我不得不升级swagger，除了swagger之外，一切都可以正常工作。由于某种未知的原因，当我试图生成Swagger的json映射时，它返回了这个异常。我在Catalina macOs上做了这些修改，macBook专业版。
The command "dotnet swagger tofile --output .\autogenerated-api.json bin/Debug/netcoreapp3.1/App.dll v2" exited with code 134.
...
U
浏览 1提问于2020-10-14得票数 0
我正试图使用rest核心3为我的rest生成一个傲慢的文档，我在这里搜索了其他问题，似乎找不到任何有用的建议。控制器非常简单，没有抽象，没有泛型，所有的方法都有http属性等。
我尝试过v4包和v5 rc2包。v4包在加载时只会导致.net核心中的运行时异常。v5包总是在.json文件中生成一个空引用异常。控制器是编码的，工作正常，只是在其中添加文档。只是想知道swashbuckle是否与.net核心3一起工作。
//Register the Swagger generator, defining one or more Swagger documents
services.A
浏览 1提问于2019-08-25得票数 3
回答已采纳
我用Azure B2C在B2C 6上实现了身份验证和授权，除了Swagger提供的授权模式上的Logout按钮之外，一切都很好，因为它似乎将用户注销，但是在“注销”之后，用户可以单击“授权”，然后再次登录，而无需输入他们的用户名和密码。它没有从浏览器中清除用户会话。在用vueJs开发的客户端上，注销工作正常，问题只发生在swagger上，我试图跟踪HTTP请求的流程，而单击注销按钮似乎不会触发任何http调用以注销用户或清除他的会话。正在使用nuget软件包Swashbuckle.AspNetCore 6.3.0，有什么建议吗?谢谢
浏览 8提问于2022-04-13得票数 1
4回答
我在一个ASP.NET Web上使用Swashbuckle和Swagger。我正在设法通过Swagger传递包含Bearer令牌的授权头。我一直在搜索，但是所有的答案似乎都指向链接。
但是，这假设头的内容是预先知道的。我真的需要一种在Swagger中改变标题的方法(就在点击“试试看！”)按钮)，因为Bearer令牌每小时过期一次。类似于Postman允许您添加标题的方式。
这似乎是一个可笑的简单问题，但答案是什么呢？
浏览 10提问于2016-08-11得票数 14
回答已采纳
目前有一个项目，在其中，swagger是使用asp.net中的swashbuckle设置的。我想合并新的Swagger 。有什么简单的方法吗？
谢谢
浏览 8提问于2017-08-15得票数 1
回答已采纳
我正在尝试配置Swashbuckle，以便可以使用URL {root}/swagger.json访问生成的JSON文件。
我已经操纵了许多设置，但一直无法使它发挥作用。下面是一些示例：
// This works! JSON file is located at http://{root}/swagger/docs/v1
this.EnableSwagger(c =>
{
c.RootUrl(x => baseUrl);
c.SingleApiVersion("v1", title);
}).EnableSwaggerUi();
This wor
浏览 0提问于2016-12-07得票数 9
我使用Swashbuckle 5.6.0和Swashbuckle.Examples.3.5.1来记录WebApi2项目。我有一个操作，它使用XML主体并返回文本响应。我希望文档中包含一个XML输入的示例，例如<SampleXml><!-- example XML --></SampleXml>。
我的swagger输出如下，但为了这个问题，我将内容类型application/json添加到comsumes属性中。实际上，我只想允许application/xml和text/xml。
当我和Swagger一起看这个的时候，我看到：
当参数内容类型applic
浏览 3提问于2017-12-20得票数 2
我需要帮助覆盖swagger生成器来处理API端点，并将查询参数记录在swashbuckle中。
我已经找到了一个，它用激烈的方法解释了如何覆盖swagger生成器。
例如:我有两个相同的路由定义端点：
POST /api/customer (路由模板-> /api/customer)
POST /api/customer?f={f}&l={l} (路由模板-> /api/customer)
默认的swagger生成器的问题是它给出了与相同端点的冲突。我尝试了ResolveConflictingActions方法，但没有起到多大作用。
需要实际工作代码的帮助
浏览 2提问于2019-01-11得票数 0
我使用的是asp.net 5
我有两个模型类，它们是嵌套的，两个内部类都名为Command。
public class EditModel
{
public class Command
{
public int Id { get; set; }
public string Info { get; set; }
}
}
和
public class CreateModel
{
public class Command
{
public int Id { get; set; }
public string I
浏览 2提问于2020-12-08得票数 5
9回答
我已经在WebApi 2应用程序中集成了swagger。当应用程序只有一个控制器时，它工作得很好。当我在应用程序中添加第二个控制器时。我发现了以下错误：
出现了一个错误。“，”ExceptionMessage“：”Swagger2.0不支持:路径‘api/凭据’和方法'GET‘的多个操作。参见配置设置- \"ResolveConflictingActions\“作为潜在的解决办法”，"ExceptionType":"System.NotSupportedException"，"StackTrace":“at Swashbuckl
浏览 10提问于2016-09-20得票数 40
我正在尝试将Swagger文档添加到我现有的.Net (不是核心)应用程序接口中。我知道Swashbuckle是一个生成Swagger UI使用的Json的有价值的工具，但是Swashbuckle为我的API生成的Json不是很好，而且编写我自己的Json规范会更简单。另一方面，Swashbuckle将Swagger-UI集成到我的API代码库中真的很方便。 有没有什么方法可以简单地将Swagger-UI指向我自己的Json，而不是用Swashbuckle生成一个Json，或者我最好把Swashbuckle放在一起？ 这里的任何指导都是很棒的！谢谢
浏览 13提问于2019-01-25得票数 1
我有一个Swagger框架(不是核心)，其中我使用Swashbuckle为我的.net自动生成Swagger文档。 我还添加了Swashbuckle examples。 我想使用SwaggerResponseExample来显示示例返回数据，但是在Swagger UI中，结果总是嵌套在application/json下 此here上有一个旧问题，但没有解决方法。 有没有人有解决这个问题的办法？我没有看到Swashbuckle的进一步更新(因此没有任何嵌入式Swagger UI)。
浏览 61提问于2020-11-11得票数 2
我正在使用用于.net核心的最新版本的swashbuckle，并且我希望swashbuckle重新检查属性描述，以便对于所有参数，说明将用于swagger文件。
public class dtoClass
{
[System.ComponentModel.Description("desciption swagger Name")]
public string name {get; set; }
}
斯巴什扣中是否有扩展点/过滤器可供使用？
我目前的解决办法是添加SwaggerSchema属性。
public class dtoClass
{
[Syst
浏览 3提问于2021-12-07得票数 0
我试图使用AzureAD在swagger中获得令牌，并使用它测试.netCore2.1 API。(使用Swashbuckle.AspNetCore 4.0.1)
为此，我完成了以下步骤
1. Created a Web API project(asp.net Core2.1)
2. Register an Azure AD (AAD) app for the Web API
3. Updated the Web API project to use Azure AD authentication
4. Register an AAD app for the Swagger web site
浏览 2提问于2019-03-13得票数 1
我已经使用Swashbuckle.AspNetCore.Swagger记录了我的应用程序接口，并且我想使用swagger ui测试一些具有Authorize属性的资源。
api接口
using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Mvc;
using System.Linq;
namespace Api.Controllers
{
[Route("[controller]")]
[Authorize]
pu
浏览 14提问于2017-08-21得票数 14
回答已采纳
当使用下面的命令行时，我从文章PowerShell中获得主题错误消息，同时使用示例MS 脚本
dotnet swagger "tofile" --output "../../res/swagger.json" "../Sample.Api/bin/Debug/netcoreapp2.1/Sample.Api.dll" v1
被处决了。解决办法？
FYI: Swashbuckle.AspNetCore.Cli条目源代码位于这里：
更新
我应该发布运行时错误消息的全文--如下所示：
At C:\Tests\Swashbuckle\build.ps1:
浏览 1提问于2018-12-29得票数 4
回答已采纳
我们正在使用SwashBuckle 5.0，并试图生成一个swagger doc 2.0。显然，它产生的swagger.json并不是100%符合swagger 2.0规范。问题具体在于它是如何登记枚举的：
name: prop-name
description: something
type: array
items:
$ref: '#/definitions/mytype'
它应该在哪里：
name: prop-name
description: something
type: array
items:
type: string
enum:
- It
浏览 1提问于2020-05-22得票数 1
我试图通过Swagger & Swashbuckle使用XML注释为我的Web项目生成API文档。在一个动作上使用ActionName属性似乎破坏了这条线上的某些东西。该操作包含在生成的XML中，并显示在Swagger中，但是当我单击它时没有细节(摘要、param等)。我不确定这是.NET、Swagger还是Swashbuckle的问题。
我尝试过使用和不使用ActionName属性，它似乎对生成的XML没有任何影响。但是，该属性确实更改了Swagger中显示的名称。这让我相信这可能和Swagger/Swashbuckle有关..。也许是ApiExplorer？
浏览 5提问于2014-11-07得票数 0
回答已采纳
扫码
添加站长 进交流群
领取专属 10元无门槛券
手把手带您无忧上云
相关资讯
热门标签
云服务器
ICP备案
对象存储
实时音视频
即时通信 IM活动推荐
腾讯云开发者
