Questions tagged «swagger-ui»

有没有一种方法可以将所有枚举显示为字符串形式，而不是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") .. } // …

107 c#  asp.net-web-api  asp.net-web-api2  swagger-ui  swashbuckle 

我已经使用Swagger UI来显示我的REST Web服务并将其托管在服务器上。 但是，只能在特定服务器上访问Swagger的服务。如果我想脱机工作，有人知道如何使用Swagger UI创建静态PDF并使用它吗？此外，PDF易于与无法访问服务器的人员共享。 非常感谢！

93 pdf  swagger-ui 

我的项目有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 …

92 spring-mvc  swagger  swagger-ui  swagger-2.0  springfox 

我有一个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": …

83 c#  asp.net-core  swagger-ui 

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

79 api  authorization  swagger  swagger-ui 

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

78 c#  asp.net-web-api  swagger-ui  swashbuckle 

使用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 …

76 c#  asp.net-web-api  asp.net-web-api2  swagger-ui  swashbuckle 

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

70 swagger-ui  swashbuckle 

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

67 swagger-ui 

最近两年，我与Springfox合作开发了Spring Boot应用程序。Springfox为您的REST API生成文档和测试ui。太棒了 但是实际上Springfox项目已经死了，并且不支持最新的Spring。我有三个问题 还有其他直接生成Swagger UI的方法吗？还有其他图书馆/项目吗？ 如何在Spring Boot项目中实现swagger ui？ 也许已经过时了，对于Spring Boot来说，有没有更好的选择？ 更新 经过数月的大量使用和测试 SpringDoc OpenApi 我会说这不是springfox的替代品，它要好得多！稳定，易于使用且最新！ 我可以100％推荐这个！我们将所有项目迁移到SpringDoc OpenApi。

11 spring-boot  swagger  swagger-ui  springfox