无法正确呈现插入符号的Swagger UI/Swashbuckle响应描述
Swagger UI/Swashbuckle是一种用于构建和展示API文档的工具。它提供了一个可视化界面，使开发人员和用户能够更好地理解和测试API的功能和参数。
Swagger UI/Swashbuckle的主要功能包括：
- API文档展示：Swagger UI/Swashbuckle可以根据API的注释和配置自动生成可视化的API文档，包括API的路径、参数、请求和响应示例等信息。这样，开发人员和用户可以更方便地查看和理解API的功能和使用方法。
- 参数验证：Swagger UI/Swashbuckle可以根据API的定义验证请求参数的合法性，包括参数的类型、格式、范围等。这样，开发人员和用户可以在调用API之前就知道需要提供哪些参数以及参数的要求，避免了因参数错误而导致的请求失败。
- 请求测试：Swagger UI/Swashbuckle提供了一个交互式的界面，可以让开发人员和用户直接在界面上输入参数并发送请求，以测试API的功能和返回结果。这样，可以更方便地进行API的调试和测试，提高开发效率。
- 安全认证：Swagger UI/Swashbuckle支持常见的安全认证方式，如基本认证、OAuth等。这样，开发人员和用户可以在界面上输入认证信息，并在发送请求时自动添加认证头，保证API的安全性。
- 扩展性：Swagger UI/Swashbuckle提供了丰富的扩展机制，可以通过自定义插件和样式来满足特定的需求。开发人员可以根据自己的需求扩展Swagger UI/Swashbuckle的功能，以适应不同的项目和场景。
推荐的腾讯云相关产品是API网关（https://cloud.tencent.com/product/apigateway），它是腾讯云提供的一种高性能、高可用的API管理服务。API网关可以与Swagger UI/Swashbuckle结合使用，通过配置API网关的API文档和参数验证功能，实现更全面的API管理和测试。
相关·内容
我正在尝试将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
我最近提议使用swashbuckle将swagger集成到我们的web-apis中，以便在内部向我们的工程师公开APIs功能。出于我们的目的，swagger在生产中没有意义，因为apis是后端的.....作为一个企业环境，API的数量是巨大的，我可以预见两个主要问题：
组装的大小约为2.6MB:假设有数百个集成了swahbuckle的apis，我们所有应用程序的大小突然增加了4.5倍。一个不合理的打击。看看swashbuckle.core，我怀疑大部分大小来自于捆绑的swagger-ui。是否有可能将swagger-ui从swashbuckle中解绑出来，转而允许通过单独的nuget包添加sw
浏览 1提问于2015-09-24得票数 4
1回答
我想在swagger-ui中为.Net核心生成的SwashBuckle自定义请求正文。 我需要当用户在swagger-ui中点击"Try it Out“时，请求主体与我的Controller API中的FromBody模型不同。 这是因为我的FromBody模型是一个“对象”类型。因此，请求正文在Swagger-Ui上显示为{}。 我使用的是.Net核心2.1和SwashBuckle 4.0.1。 谢谢
浏览 41提问于2020-04-23得票数 3
我在一个.Net项目中使用Swashbuckle和Swagger UI。我在控制器上使用以下属性。
[SwaggerResponse(HttpStatusCode.OK, "IEnumerable<EmployeeModel>", typeof(IEnumerable<EmployeeModel>))]
生成的JSON文档生成以下内容：
"responses": {
"200": {
"description": "IEnumerable<Emplo
浏览 6提问于2017-01-21得票数 0
回答已采纳
我在一个项目中遇到了一个问题，由于各种原因，我们无法依靠swashbuckle来生成项目所需的swagger.json，只能自己手工编写。我一直在到处搜索，但一直无法弄清楚如何配置它，以便当人们在主页url中输入/swagger时，它将默认使用我的swagger.json文件，而不是由swashbuckle自动生成的文件，这对我们不起作用。用户被迫通过在用户界面顶部的"swagger url bar“中输入文件路径来手动更改到我的页面，这导致了很多混乱。
任何人都可以分享完成这项工作所需的代码/设置吗？(假设我可以)或者建议一个更好的swagger库(它有关于如何实现的清晰文档)，如果
浏览 10提问于2017-08-25得票数 1
回答已采纳
我正在尝试从Swashbuckle 4升级到5，从swagger 1.2升级到2。
我遇到的问题是，如果响应中包含另一个对象，那么响应模式就不会正确显示。
在使用Swagger1.2时，我的模型模式如下所示：
{
"Id": "",
"FirstName": "",
"LastName": "",
"Address": {
"StreetNumber": "",
"City": "",
浏览 1提问于2015-04-20得票数 0
回答已采纳
1回答
我已经安装了Swashbuckle来为我的webapi配置Swagger。但在浏览时，我无法查看swagger UI。
错误：
如何在webapi中启用swagger UI。
浏览 4提问于2018-11-12得票数 0
我有一个使用.NET编写的Swashbuckle.AspNetCore.SwaggerGen核心项目(Swashbuckle.AspNetCore.SwaggerGen 3.0.0和Swashbuckle.AspNetCore.SwaggerUi 3.0.0)。我的目标是在DIV下面添加一个带有类标题的自定义标记(即在服务名称下面，但在端点之上)。
当我研究Swagger标记时，我看到有一个带有类swagger-ui的DIV，可以这么说，我想将我的东西插入其中。我今天拥有的设置是一个名为donkey.html的文件，当我访问Swagger的URL时，它将呈现如下所示。
...
<body
浏览 0提问于2018-10-12得票数 4
回答已采纳
我从事一个ASP.NET Core 3.1 web项目。我使用Swashbuckle.AspNetCore 5.0.0来记录我的API。一切都很顺利。但是，由于api使用中间件来包装每个响应以保持一致性，所以我不得不生成响应类型。我无法生成正确的响应类型在我的傲慢的ui。
下面是一个简单的例子，
我的行动方法：
[HttpGet]
[ProducesResponseType(200, Type = typeof(IEnumerable<WeatherForecast>))]
public IEnumerable<WeatherForecast> Get()
...
正如
浏览 2提问于2020-03-12得票数 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
更新到.NET核心3.1和最新版本的斯瓦什巴克尔，但发现傲慢的UI没有正常工作。swagger-ui-bundle.js未能加载502。跟踪到AWS ALB错误，称响应太大。针对Lambda的ALB将响应限制在1MB。确认了swagger-ui-bundle.js几乎是1MB (技术上为995 is )。
有什么办法可以缩小swagger-ui-bundle.js的大小，或者其他引用它的方法(可能是通过CDN )？
我正在使用Swashbuckle.AspNetCore 5.5.1Nuget包和.NET核心3.1。
浏览 7提问于2020-08-11得票数 3
正如Scott在//Build会议上所演示的那样，我正在尝试用Swagger + Swashbuckle建立一个Api应用程序(Azure)：。
我已经安装了(使用NuGet)包Swagger.Api和Swashbuckle.Core。它没有添加任何控制器或设置，我希望有一个昂首阔步的页面。当我导航到{baseUrl}\swagger时，会得到一个404错误。
我想，既然它有一个UI，除了Api应用程序之外，它还需要一个Web应用程序，但我重新观看了演示，Scott明确地说，您可以在任何Api应用程序中添加Swagger + Swashbuckle。不过，在第二个应用程序中，我认为Api发现可
浏览 5提问于2015-05-05得票数 8
回答已采纳
我有一个Swagger框架(不是核心)，其中我使用Swashbuckle为我的.net自动生成Swagger文档。 我还添加了Swashbuckle examples。 我想使用SwaggerResponseExample来显示示例返回数据，但是在Swagger UI中，结果总是嵌套在application/json下 此here上有一个旧问题，但没有解决方法。 有没有人有解决这个问题的办法？我没有看到Swashbuckle的进一步更新(因此没有任何嵌入式Swagger UI)。
浏览 61提问于2020-11-11得票数 2
我想我也有一个类似的问题- 。
与基于katana-owin的web一起运行的Swashbuckle能够与IIS一起工作。
假设下面的所有urls都有一个"http“前缀。我可以浏览到localhost:8085/swagger，它正确地将我重定向到localhost:8085/swagger/ui/index
但是当发布到IIS时，将重定向到localhost/swagger/ui/index，而不是localhost/myapp/swagger/ui/index，这将导致404。请注意，即使在发布时指定了应用程序名称，swashbuckle/swagger也不知道，并且只使用路径基
浏览 2提问于2015-04-23得票数 3
回答已采纳
我有一个场景，我的ASP.NET WEB API根据请求对象返回2个不同的模型。我正在使用swagger UI (通过swashbuckle)来记录我的ASP.NET WEB API，但目前无法找到一种方法来记录这两个模型和1个ASP.NET WEB API操作。我试过用谷歌搜索，但收效甚微。任何帮助都将不胜感激。
浏览 2提问于2017-08-22得票数 0
回答已采纳
我正在尝试使用由Swashbuckle.AspNetCore (3.0.0)创建的Autorest和Swagger文档来生成REST API客户端。
生成的swagger文档似乎是正确的，除了操作名称并不是很好。
"/api/Addresses/{id}": {
"get": {
"tags": [ "Address" ],
"operationId": "ApiAddressesByIdGet",
"consumes":
浏览 116提问于2018-08-23得票数 20
回答已采纳
我跟随向我的ASP.NET核心应用程序添加了swagger。
当我把它作为根网站托管时，它工作得很好，但是当我将应用程序作为别名托管在一个现有的网站上时，比如myserver.com/myapp，swagger会在一个不正确的URL和报告中查找swagger.json：*无法从https://myserver.com/swagger/v1/swagger.json中读取swagger JSON。它应该使用https://myserver.com/myapp/swagger/v1/swagger.json。
我得到的信息是：
无法从读取swagger JSON
如何配置swashbuck
浏览 4提问于2016-12-02得票数 3
1回答
我插入了Swashbuckle.AspNetCore，并开始使用swagger UI来调试我的Rest API。我很乐意得到对象的每个属性的输入，而不是整个对象的大文本区。我该怎么做呢？
浏览 0提问于2019-04-18得票数 0
我已经向类成员添加了XML注释，但是Swagger不会在UI中显示它们。我做错了什么吗？
更新:看起来您无法用@ApiModel和@ApiModelProperty注解在Swashbuckle (5.5.3)中记录您的模型类，而且xml注释也不起作用。
public class DataController : ApiController
{
[Route("api/GetData")]
[SwaggerResponse(HttpStatusCode.OK, Type = typeof(MyData))]
public System.Web.Mv
浏览 23提问于2017-01-31得票数 20
我已经使用Swashbuckle将swagger集成到了一个dot.net核心应用程序接口应用程序中。当我在没有提供凭证的情况下通过Swagger UI执行一个API时，它会像预期的那样返回一个"401- Unauthorized“响应。 但它没有显示错误响应，我已将其配置为作为正文作为自定义错误响应返回。它会返回标题，如下图所示。 当我通过Postman执行相同的API时，它确实返回自定义错误响应，如下所示。 我需要的是，我还需要在swagger UI中看到自定义错误响应正文。 在邮递员中， ? 在斯威格， ? 使用403和404状态代码的情况相同。
浏览 45提问于2021-07-27得票数 0
3回答
我在一个ASP.NET MVC WebAPI项目中使用Swagger。这个项目已经安装了Swashbuckle块金包，并生成Swagger UI和Swagger/docs/v1。我遇到的一个始终如一的问题是，开发人员会因为没有仔细命名他们的webAPI操作而破坏swagger文件。我想添加一个单元测试，以防止在部署后转到Swagger UI站点并在swagger UI中显示HTTP 500时发现swagger/docs/v1不可用。有人知道如何编写单元测试来验证Swashbuckle可以成功生成swagger文档吗？
浏览 3提问于2015-10-18得票数 8
2回答
我使用包Swashbuckle.AspNetCore.Annotations中的这样的注释来定义swagger的响应：
[SwaggerResponse(200, "OK", typeof(SampleResponseClass))]
这个包也可以定义响应的头吗？如果没有，还会有什么其他的可能性呢？
浏览 2提问于2021-10-25得票数 1
我在我的带有基本身份验证的.NET Web API中使用Swashbakle5.3版本(根据这个)。现在，当我尝试更新Swashbuckle 5.6版本时，它抛出了错误'Key is not found‘。问题出在下面的代码片段中。在路由映射期间，它无法从路由集合中找到'swagger_ui‘。我尝试了其他不同的路由值(如'swagger‘，'/swagger'，'swagger/docs’)，但它们都不起作用
var route = config.Routes["swagger_ui"];
config.Rou
浏览 0提问于2017-09-27得票数 0
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
回答已采纳
当模型的属性是列表时，swashbuckle\swagger-ui (5.6 - using swagger-ui)似乎不能正确生成示例XML。
要查看此问题，请执行以下操作：
1-创建一个空的webapi项目(我使用的是asp.net)
2-添加几个示例模型(我选择客户+订单进行测试)
public class Customer
{
public string AccountNumber { get; set; }
[XmlArray("Orders"),XmlArrayItem("Order")]
public List<Ord
浏览 2提问于2018-11-09得票数 0
1回答
因此，我从这里创建研讨会应用程序：
()
我已经开始在ASP.Net Core3.0应用中配置虚张声势了。UI本身是有效的，但是
我无法访问我在控制器中定义的路由，也无法在URL中获取它们，因为尽管路由是在https://localhost:5001/swagger/v1/swagger.json中定义的，但所有内容都会重定向到https://localhost:5001/swagger/index.html。
例如，我无法访问：https://localhost:5001/api/Speakers或任何其他路由，因为所有内容都重定向到https://localhost:5001/swagge
浏览 2提问于2019-11-17得票数 1
4回答
现在，我正在开发一个ASP.Net Web，并使用它的文档。我知道Swashbuckle在内部使用Swagger-UI，我知道我们可以通过注入css或javascript文件来修改布局，甚至可以更改index.html的布局。
我为Swagger 找到了一个很好的主题，并试图实现它，但无法使它工作。尤其是当我想注入bootstrap.js的时候。我是否可以完全改变Swashbuckle实现，这样我就可以使用回购中的解决方案了吗？
浏览 5提问于2015-07-27得票数 16
回答已采纳
在我在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
我的理解是：
Swagger是编写文档的一种符号/规则。但是为什么它被称为一个框架(比如角/MVC)？
斯巴什巴克尔是一个程序(JavaScript?)生成文档(基于Swagger规则)。
Swagger显示文档。它用斯瓦什巴克尔来做这个。
这个信息正确吗？如果不是，有人能用简单的术语解释Swagger，Swashbuckle和Swashbuckle的含义吗？
另外，如果我不使用这个API开发人员，我会失去什么呢？
浏览 1提问于2017-04-16得票数 53
回答已采纳
我正在升级一个项目，以便从2.2升级到使用.Net Core3.1，并且正在努力让我的工具正常工作。 我在我的.csproj文件中有这一节，它在发布时生成一个swagger.json文件-它在我们的构建管道中执行，并作为工件发布。 <ItemGroup>
<DotNetCliToolReference Include="Swashbuckle.AspNetCore.Cli" Version="5.2.1" />
</ItemGroup>
<Target Name="Swagger" AfterTar
浏览 23提问于2020-04-03得票数 2
我有以下行动
POST /odata/Individuals({individualId})/Default.SendEmail
使用Swashbuckle生成Swagger文档是为OData设置和配置的，并正确地记录了这些文档。
当我启用非限定名调用时
config.EnableUnqualifiedNameCall(true);
该路由正确地工作于
POST /odata/POST({individualId})/SendEmail
然而，Swagger仍然用“默认”显示原版。前缀，测试不再从Swagger UI中运行。
我如何既允许Default.SendEmail和Se
浏览 3提问于2016-12-28得票数 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
回答已采纳
我有一个场景，其中POST方法返回"image/png“内容。这个API在邮递员中运行得很好，我可以看到一个图像。
我使用Swagger来记录我的API。由于某种原因，“尝试”功能使返回图像的POST方法崩溃。它在加载时冻结，我在浏览器控制台中看到以下内容：
cannot parse JSON/YAML content
swagger-ui-min-js:14 Uncaught TypeError: Failed to execute 'createObjectURL' on 'URL': No function was found that matc
浏览 8提问于2017-07-20得票数 3
回答已采纳
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
我们有许多服务，它们使用SwashBuckle / Swagger UI来公开REST方法。 当您在浏览器的选项卡中打开其中几个选项卡时，您无法立即从选项卡中看到服务名称，这通常是令人恼火的。至少在不切换到该选项卡的情况下不会 是否可以从SwashBuckle更改HTML标题？ ?
浏览 34提问于2021-09-24得票数 0
回答已采纳
我们在代码中使用JetBrains注释来定义对象模型的空性行为。默认情况下，我无法在使用Swashbuckle.AspNetCore v5.0.0-rc5实现的Swagger UI中看到这些，所以我假设默认情况下不支持这些。有什么方法可以添加这个特性吗？ 仅供参考，我使用的是ASP.NET Core WebApi 3.1。 例如： public class Person {
[NotNull]
public Id PersonId{get; set;}
[CanBeNull]
public Address Address {get;set;}
}
浏览 35提问于2020-01-09得票数 2
回答已采纳
我正在使用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
回答已采纳
我最近使用ASP.NET Core3.1将一个ASP.NET核心API应用程序升级到了Swashbuckle/Swagger5.0.0。
<PackageReference Include="Swashbuckle.AspNetCore" Version="5.0.0" />
<PackageReference Include="Swashbuckle.AspNetCore.Swagger" Version="5.0.0" />
<PackageReference Include="Swash
浏览 19提问于2020-02-17得票数 11
回答已采纳
在API或Classic ASP.NET中，我们可以使用Swashbuckle生成漂亮的ASP.NET文档，包括用于直接从您的路由、控制器和模型探索和测试操作的UI。 我有不同的用例。我已经有了swagger .json文件(2.0版)。我希望将该文件加载到Swashbuckle中，Swashbuckle是否可以将Swagger UI HTML作为字符串返回？ 一旦我获得了字符串，我将在下一行过程中的其他地方使用它
浏览 6提问于2019-01-17得票数 0
我和斯威格有个奇怪的问题...我正在使用版本化的API，事实上，版本化是有效的……但是，我有两个问题让我感到困惑。我已经为两个单独的API版本进行了配置，这样我就可以进行测试了……v1.0和v2.0。我已经将版本化的属性放入了控制器以及它们的操作中，以稍微混淆一下，看看Swagger中的版本化是否只显示了与每个版本相关的端点。
我遇到的问题是: a.)每个端点的Swagger输出中呈现的路由不是以major.minor格式(即: v1.0)显示的，而是"/api/v1/...“。我希望路由是"/api/v1.0/...“。有谁知道怎么解决这个问题吗？b.)无论我从页面顶部的下拉
浏览 3提问于2021-03-16得票数 0
1回答
在一个.Net核心web API中，我使用Swashbuckle集成了Swagger。API是受保护的，因此在Swagger UI中执行某些请求之前，用户需要进行授权和登录。这一切都很好用。 现在，一个API调用创建一个预签名的URL，并向文件服务器返回一个HTTP重定向(预签名的URL)。 问题是Swagger UI将带有JWT令牌的授权头发送到文件服务器(MinIO)。这会导致文件服务器接收两种不同的身份验证机制，并以无效请求作为响应。 有没有办法影响Swagger UI处理重定向的方式，或者不在重定向上发送令牌？
浏览 27提问于2019-06-13得票数 3
回答已采纳
我已经将ASP.NET WebApi配置为Swashbuckle，以显示傲慢的ui。我在IIS Express中的VS中运行它。解决方案是在VS 2013年，它运作良好。迁移到VS 2015之后，就没有任何方法了。没有错误，只有空列表。返回的答复是：
{"swagger":"2.0","info":{"version":"v4","title":"Swashbuckle Dummy API V4"},"host":"localhost:35622",&
浏览 3提问于2015-09-14得票数 0
回答已采纳
我有一个C# WebAPI项目，它的方法使用自定义ModelBinder作为其输入参数。当我查看Swashbuckle生成的Swagger UI时，而不是有一个单一的"body“参数，方法的参数的所有属性都分别列出。如果我摆脱了ModelBinder属性并切换到使用FromBody属性，Swagger显示了正确的东西。我必须使用ModelBinder属性，所以关闭它不是一种选择。
是否有一种方法可以让Swashbuckle生成"FromBody属性样式“单个参数，而不是它正在执行的多个参数？
浏览 2提问于2015-05-24得票数 5
回答已采纳
使用Web和使用swashbuckle生成swagger文档，我在两个不同的名称空间中定义了两个同名的不同类。当我在浏览器中打开“傲慢”页面时，上面写着：
冲突schemaIds:为A和B类型检测到的重复schemaIds -参见配置设置- "UseFullTypeNameInSchemaIds“作为潜在的解决方法
全文：
500：{“消息”：“发生了错误。”，“ExceptionMessage”：“冲突schemaIds:为类型A和B检测到的重复schemaIds”参见配置设置- \"UseFullTypeNameInSchemaIds\“用于潜在的解决办法，“Sw
浏览 9提问于2017-09-06得票数 100
回答已采纳
我在Visual Studio2017( ASP.NET框架4.6.1)中创建了一些.NET Web API项目。
我使用SwaggerConfig.cs文件启用了swagger UI。
一切都很好，我可以通过http://localhost:54408/swagger/ui/index/访问UI。
我想在应用程序启动时直接转到这个URL (默认地址是：http://localhost:54408)，因此我将项目属性(Web选项卡)中的Project Url值更改为http://localhost:54408/swagger/ui/index/。
从那时起，我就不能访问swagger UI页面
浏览 1提问于2018-05-15得票数 1
我有ASP.NET Core应用程序，在这里我使用了下面的swagger：
public void ConfigureServices(IServiceCollection services)
{
services.AddMvc();
services.AddSwaggerGen(c =>
{
c.OperationFilter<ExamplesOperationFilter>();
c.OperationFilter<DescriptionOperationFilter>();
c.Swag
浏览 1提问于2018-08-14得票数 11
回答已采纳
我正在做一个Swagger (Web API)项目。
当我第一次运行应用程序时，它显示Swagger UI的登录页面。
因此，用户首先必须登录才能访问Swagger UI页面，但是，如果用户直接输入"“，那么他就能够访问Swagger UI页面。
afaik swagger-ui由swashbuckle组件提供服务。源代码在我的项目中不可用。
如果用户没有登录到Swagger UI页面，我如何让用户重定向到登录页面？
浏览 25提问于2016-12-23得票数 11
回答已采纳
我最近完成了从斯瓦什巴克尔到的转变。在进行更改后，我遇到的一个问题是，现在我无法调用我的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
回答已采纳
我试图安装Swagger通过Nuget软件包(Swashbuckle)，但我无法使它工作。
这是一个香草与2013年Web 2项目。JS控制台上有一个错误: Uncaught :无法读取空的属性‘标记’。
在/swagger/ui/lib/下划线-min.map的请求上收到404。
我在webconfig中找到了一个建议禁用BrowserLink的链接，它使用vs:EnableBrowserLink，但似乎没有任何效果。
有什么想法吗？
浏览 3提问于2015-03-09得票数 4
回答已采纳
2回答
我使用AWS网关创建了API。然后，我记录了所有实体的文档部分(如API、资源、方法、模型等)。然后，使用AWS控制台，我将文档发布到dev阶段，并使用1版本
但我不确定我(或API的使用者)如何访问文档？
有一个Export选项可以将文档导出为Swagger或OpenAPI3。这将创建.json或.yaml文件，然后消费者必须将这些文件导入swagger。但是，这并不是用户友好的选择，每次我更新文档给所有消费者时都会提供swagger文件。
我想知道，在发布文档之后，无论如何，消费者可以通过http直接访问文档。因此，让我们假设我的dev阶段api是https://devapi.exampl
浏览 2提问于2019-01-15得票数 21
扫码
添加站长 进交流群
领取专属 10元无门槛券
手把手带您无忧上云
相关资讯
热门标签
云服务器
ICP备案
对象存储
实时音视频
云直播活动推荐
腾讯云开发者
