Questions tagged «swashbuckle»

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

30
ASP.NET Core-Swashbuckle不创建swagger.json文件
我在获取Swashbuckle.AspNetCore(1.0.0)包来生成任何输出时遇到麻烦。我阅读了swagger.json文件,应将其写入“〜/ swagger / docs / v1”。但是,我没有得到任何输出。 我从一个全新的ASP.NET Core API项目开始。我应该提到这是ASP.NET Core2。该API可以正常工作,并且我可以从值控制器中检索值。 我的启动类的配置与本文(GitHub上的Swashbuckle.AspNetCore)完全相同。 public class Startup { public Startup(IConfiguration configuration) { Configuration = configuration; } public IConfiguration Configuration { get; } // This method gets called by the runtime. Use this method to add services to the container. public void ConfigureServices(IServiceCollection services) …

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

5
NET Core 3.0的JWT身份验证和Swagger
我正在使用.Net core 3.0开发一些Web Api,并希望将其与SwashBuckle.Swagger集成。它工作正常,但是当我添加JWT身份验证时,它无法按我预期的那样工作。为此,我添加了以下代码: services.AddSwaggerGen(c => { c.SwaggerDoc("v1", new Microsoft.OpenApi.Models.OpenApiInfo { Title = "My Web API", Version = "v1" }); c.AddSecurityDefinition("Bearer", new OpenApiSecurityScheme { Description = "JWT Authorization header using the Bearer scheme. Example: \"Authorization: Bearer {token}\"", Name = "Authorization", In = ParameterLocation.Header, Type = SecuritySchemeType.ApiKey }); }); 添加AddSecurityDefinition功能后,我可以看到“授权”按钮,当我单击它时,会看到以下表单: 然后输入Bearer …
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.