jjzjj

swagger-editor

全部标签

c# - 如何设置 SwashBuckle.AspNetCore.Swagger 以使用授权?

我已经使用Swashbuckle.AspNetCore.Swagger记录了我的api,我想使用swaggerui测试一些具有Authorize属性的资源。接口(interface)usingMicrosoft.AspNetCore.Authorization;usingMicrosoft.AspNetCore.Mvc;usingSystem.Linq;namespaceApi.Controllers{[Route("[controller]")][Authorize]publicclassIdentityController:ControllerBase{[HttpGet]publi

c# - 如何从根 url 重定向到/swagger/ui/index?

我有一个安装了Swashbuckle的WebApi项目。在默认设置中,我必须在浏览器中打开http://localhost:56131/swagger/ui/index以查看我的操作描述和测试页面。我希望它可以从站点的根目录访问:http://localhost:56131/。我怎样才能做到这一点? 最佳答案 受thisanswertosimilarquestion影响,稍作修改的代码:publicclassWebApiConfig{publicstaticvoidConfigure(IAppBuilderapp){varhttpC

c# - 有没有办法在 swagger-ui 页面中更改 Controller 的名称?

我正在使用Swashbuckle在我的WebApi项目中启用swagger和swagger-ui。在下图中,您可以看到我的两个Controller显示在swagger-ui页面中。它们的命名与它们在C#代码中的名称相同,但我想知道是否有办法更改此处显示的内容?这主要是因为如您所见,ManagementDashboardWidget不是用户友好的名称,因此我想将其更改为用户友好的名称。 最佳答案 从ASP.NETCore6开始,您可以使用TagsAttribute在Controller级别:[Tags("entity")][ApiCo

c# - 如何在 ASP.NET Core 中更改 Swagger 的基本 URL

默认情况下,当您在ASP.NETCore项目中启用swagger时,它在url上可用:http://localhost:/swagger/ui我想使用不同的基本url而不是/swagger/ui。我如何/在哪里配置它?我发现对于旧版本你可以配置RootUrl但在ASP.NETCore中没有类似的方法:.EnableSwagger(c=>{c.RootUrl(req=>myCustomBasePath);}); 最佳答案 对于ASP.NETCore2(并使用Swashbuckle.AspNetCore.Swagger-Version4

c# - 使用 Swagger 的特定状态代码的响应模型

我正在使用Swagger记录我的RESTAPI(使用asp.netwebapi2)。有没有办法Swagger为给定api调用的每个可能响应提供响应模型?我正在使用xml注释注释状态代码响应,如下所示://////Saveaperson//////Ok///BadRequest///InternalServererrorpublicHttpResponseMessageSavePerson(){...} 最佳答案 您可以像这样在您的XML注释上尝试使用cref="TYPEHERE"。///BadRequest乙但我建议使用Swagge

Swagger 3 对比于 Swagger 2 更新了哪些内容,做了哪些优化 ?Swagger 3 解读

文章目录Swagger3对比于Swagger2更新了哪些内容,做了哪些优化?Swagger3解读相关阅读传送门`Process`支持OpenApi`Process`提供更方便的依赖形式`Process`接口地址的变化`Process`注解的变化`Process`Docket的变化参考资料Swagger3对比于Swagger2更新了哪些内容,做了哪些优化?Swagger3解读如果觉得本文对你有帮助,可以一键三连支持,谢谢相关阅读RelatedReading

c# - Web Api 如何在 Swagger 中为所有 API 添加 Header 参数

我搜索了添加请求header参数的可能方法,该参数将自动添加到我的web-api中的每个方法,但我找不到明确的方法。在搜索时我发现方法OperationFilter()必须对此做一些事情。 最佳答案 用户“GT”写的是正确的,但它不适用于Swagger5。我们有一些新的变化:从:操作到:OpenApiOperation从:IParameter到:OpenApiParameter从:NonBodyParameter到:OpenApiParameter,最重要的是...从:Type="string"到:Schema=newOpenApi

c# - 如何使用 Swashbuckle 在 Swagger API 文档/OpenAPI 规范中包含子类?

我在C#中有一个Asp.NetWebAPI5.2项目并使用Swashbuckle生成文档。我有一个包含继承的模型,例如具有来自Animal抽象类的Animal属性以及从它派生的Dog和Cat类。Swashbuckle仅显示Animal类的模式,因此我尝试使用ISchemaFilter(他们也建议这样做)但我无法使其工作,而且我找不到合适的示例。有人可以帮忙吗? 最佳答案 似乎Swashbuckle没有正确实现多态性,我理解作者关于子类作为参数的观点(如果一个Action需要一个Animal类并且如果你用狗对象或猫对象调用它时表现不同

javascript - 从 Swagger 生成静态 Javascript 客户端以在 React Native 中使用

我正在构建一个ReactNative应用程序,它将使用具有Swagger2.0定义的API。我去了Swagger的仓库https://github.com/swagger-api/swagger-codegen#where-is-javascript它指向他们的Javascript生成器https://github.com/swagger-api/swagger-js.问题是生成器是动态的,因为我会将客户端嵌入到移动应用程序中,动态生成器不是一个选项。他们还说在https://github.com/wcandillon/swagger-js-codegen有一个第三方项目可用。,表示该

javascript - Swagger-Codegen:如何将所有文件合并到一个文件中以进行客户端代码生成

我刚刚开始使用Swagger和NodeJS。我能够将Swagger实现到我的NodeExpress应用程序,并且还能够准确地使用Swagger-Codegen(Typescript-Angular)生成typescript-client-code。我遇到的一个问题是生成的代码分布在许多不同的文件中。我希望它只输出一个文件api.ts,它包含API调用和接口(interface)/模型的所有内容。我一直在寻找解决这个问题的方法,因为随着后端的增长,很难阅读和维护生成的客户端代码。如有任何建议或指点,我们将不胜感激。节日快乐!谢谢编辑:几天来我一直在寻找这个问题的答案,但仍然没有找到。我目