Questions tagged «swagger-ui»

Swagger UI是HTML,CSS和JavaScript对象的集合,这些对象从与Swagger兼容的API动态生成文档

19
Swagger UI Web Api文档将枚举形式表示为字符串吗?
有没有一种方法可以将所有枚举显示为字符串形式,而不是int形式? 我希望能够提交POST操作并根据其字符串值放置枚举,而不必每次都查看该枚举。 我试过了,DescribeAllEnumsAsStrings但是服务器然后接收字符串而不是我们想要的枚举值。 有人解决了吗? 编辑: public class Letter { [Required] public string Content {get; set;} [Required] [EnumDataType(typeof(Priority))] public Priority Priority {get; set;} } public class LettersController : ApiController { [HttpPost] public IHttpActionResult SendLetter(Letter letter) { // Validation not passing when using DescribeEnumsAsStrings if (!ModelState.IsValid) return BadRequest("Not valid") .. } // …

6
从Swagger API文档生成PDF
我已经使用Swagger UI来显示我的REST Web服务并将其托管在服务器上。 但是,只能在特定服务器上访问Swagger的服务。如果我想脱机工作,有人知道如何使用Swagger UI创建静态PDF并使用它吗?此外,PDF易于与无法访问服务器的人员共享。 非常感谢!
93 pdf  swagger-ui 

10
如何配置Spring Security以允许无需身份验证即可访问Swagger URL
我的项目有Spring Security。主要问题:无法访问http:// localhost:8080 / api / v2 / api-docs上的大写URL 。它说缺少或无效的授权标头。 浏览器窗口的屏幕快照 我的pom.xml具有以下条目 <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.4.0</version> </dependency> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger-ui</artifactId> <version>2.4.0</version> </dependency> SwaggerConfig: @Configuration @EnableSwagger2 public class SwaggerConfig { @Bean public Docket api() { return new Docket(DocumentationType.SWAGGER_2).select() .apis(RequestHandlerSelectors.any()) .paths(PathSelectors.any()) .build() .apiInfo(apiInfo()); } private ApiInfo apiInfo() { ApiInfo apiInfo = new …

5
使用授权标头(Bearer)设置Swagger(ASP.NET Core)
我有一个Web API(ASP.NET Core),我试图调整范围以从中进行调用。调用必须包含Authorization标头,并且我正在使用Bearer身份验证。来自Postman等第三方应用程序的呼叫正常。但是我在设置标题时会遇到麻烦(出于某些原因,我没有收到标题)。现在是这样的: "host": "localhost:50352", "basePath": "/" , "schemes": [ "http", "https" ], "securityDefinitions": { "Bearer": { "name": "Authorization", "in": "header", "type": "apiKey", "description": "HTTP/HTTPS Bearer" } }, "paths": { "/v1/{subAccountId}/test1": { "post": { "tags": [ "auth" ], "operationId": "op1", "consumes": ["application/json", "application/html"], "produces": ["application/json", "application/html"], "parameters": [ { "name": …

9
如何在Swagger UI中发送带有请求的自定义标头?
我在API中一些端点- ,。/user/login/products 在扬鞭UI我交的email,并password以/user/login和为响应我收到一个token字符串。 然后,我可以从响应中复制令牌,并希望将其用作Authorization请求中的标头值到所有url(如果存在),并/products作为示例。 我应该在Swagger UI页面上的某个位置手动创建文本输入,然后将令牌放到那里并以某种方式注入请求中,或者是否有工具可以更好地管理它?

6
swagger-ui部署后返回500
开箱即用的配置可以在我的机器上完美运行,完全没有问题。 但是当我部署到我们的测试环境时,我收到以下消息 500:{“消息”:“发生错误。” } / api / swagger / docs / v1 部署是为了 default web site/api 我想它与baseUrl或类似的东西有关,但我什至不知道从哪里开始。 我的路由在项目中运行良好-我可以调用所有的webapi端点,它们可以正确响应。 任何帮助将非常感激

6
大幅度的错误:冲突的schemaIds:检测到类型A和B重复的schemaIds
使用Web API并使用swashbuckle生成详尽的文档,我在两个不同的命名空间中定义了两个具有相同名称的不同类。当我在浏览器中打开打开页面时,它说 冲突的schemaIds:检测到类型A和B重复的schemaIds。有关可能的解决方法,请参阅配置设置-“ UseFullTypeNameInSchemaIds” 完整讯息: 500:{“消息”:“发生错误。”,“ ExceptionMessage”:“冲突的schemaId:检测到类型A和B的重复的schemaId。请参见配置设置-\” UseFullTypeNameInSchemaIds \“以获取可能的解决方法”,“ ExceptionType Swashbuckle.Swagger.SchemaRegistry.CreateRegistry.CreateInlineSchema(类型)\ r \ n在Swashbuckle.Swagger。“”:“ System.InvalidOperationException”,“ StackTrace”:“在Swashbuckle.Swagger中。 SchemaRegistry.b__1f(JsonProperty prop)\ r \ n位于System.Linq.Enumerable.ToDictionary [TSource,TKey,TElement](IEnumerable 1 source, Func2 keySelector,Func2 elementSelector, IEqualityComparer1比较器)\ r \ n在Swashbuckle.Swagger.SchemaRegistry.CreateObjectSchema(JsonObjectContract jsonContract)\ r \ n在Swashbuckle.Swagger.SchemaRegistry.CreateDefinitionSchema(Type type)\ r \ n在Swashbuckle.Swagger.SchemaRegistry.GetOrRegister(Type type )\ r \ n在Swashbuckle.Swagger.SwaggerGenerator.CreateOperation(ApiDescription apiDesc,SchemaRegistry schemaRegistry)\ r \ n在Swashbuckle.Swagger.SwaggerGenerator.CreatePathItem(IEnumerable 1 …

6
Swagger UI中无法读取文件问题
我已经在应用程序中加入了swagger UI。 当我尝试查看swagger UI时,可以很好地获取API文档,但过一会儿,按钮上会显示一些错误图标。 错误消息如下所示: [{“ level”:“错误”,“ message”:“无法从文件http:// MYIP / swagger / docs / v1 ”}中读取 ] 我不确定是什么原因造成的。如果我刷新它,它会在几秒钟后显示错误。

1
昂首阔步的UI替代列表[关闭]
关闭。此问题不符合堆栈溢出准则。它当前不接受答案。 想改善这个问题吗?更新问题,使其成为Stack Overflow的主题。 1年前关闭。 已锁定。该问题及其答案被锁定,因为该问题是题外话,但具有历史意义。它目前不接受新的答案或互动。 有Swagger UI替代品吗?我已经知道: http://swaggerui.herokuapp.com/#!/pet/addPet http://public.redfroggy.fr/swagger2
67 swagger-ui 

2
有任何Springfox替代品吗?
最近两年,我与Springfox合作开发了Spring Boot应用程序。Springfox为您的REST API生成文档和测试ui。太棒了 但是实际上Springfox项目已经死了,并且不支持最新的Spring。我有三个问题 还有其他直接生成Swagger UI的方法吗?还有其他图书馆/项目吗? 如何在Spring Boot项目中实现swagger ui? 也许已经过时了,对于Spring Boot来说,有没有更好的选择? 更新 经过数月的大量使用和测试 SpringDoc OpenApi 我会说这不是springfox的替代品,它要好得多!稳定,易于使用且最新! 我可以100%推荐这个!我们将所有项目迁移到SpringDoc OpenApi。
By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.