Swashbuckle.AspNetCore
Swashbuckle.AspNetCore copied to clipboard
Swagger tools for documenting API's built on ASP.NET Core
I am porting an old API to .NET Core and to not introduce breaking changes, we want to support XML as well as JSON. I have found some undesired behaviors...
Use `SwaggerWebHostFactory` to create the custom WebHost. Run dotnet swagger cli tool to generate the openapi.yaml. The openapi linter fails because region is missing the key `default`. The error comes...
Similar to the feature request [here](https://github.com/domaindrivendev/Swashbuckle.AspNetCore/issues/541). Can you add support to generate the swagger json without Startup class? Sometimes, we use unity container rather than using `Startup` class ```cs builder...
# Pull Request ## The issue or feature being addressed This is a fix for issue [#2716](https://github.com/domaindrivendev/Swashbuckle.AspNetCore/issues/2716). There was no XML example for array response types. ## Details on the...
Hi, On any routes that expect a body (PUT, POST) I get the following error starting with 6.1.5: ` System.ArgumentException: The argument 'name' is null, empty or consists only of...
Version: 6.1.4 I have some model properties annotated with `[SwaggerSchema(ReadOnly = true)]`. When I debug and inspect the `OpenAPISchema` property corresponding to one of these model properties, its `readOnly` property...
Hi, I'm using NewtonsoftJsonSerializer with JsonApiSerializerSettings. I was trying to force Swashbuckle to generate documentation using JsonApi format: - installed Swashbuckle.AspNetCore.Newtonsoft package - used services.AddSwaggerGenNewtonsoftSupport(); - in AddNewtonsoftJson method configured...
I'm using v6.2.2 and `swaggerOptions.SerializeAsV2 = true`. Consider a class ```csharp public class Foo { public JObject Bar { get; set; } } ``` In the generated specification, I would...
Given the following: ```csharp [assembly: ApiController] [assembly: ApiConventionType(typeof(ApiConventions))] [Route("/xxx")] public class xxxController : ControllerBase { [HttpGet(Name = nameof(Getxxx))] public ActionResult Getxxx(){} [HttpPut("{itemId:guid}", Name = nameof(Updatexxx))] public ActionResult Updatexxx(Guid itemId){} }...
v6.2.3 ``` [HttpGet] public IActionResult ActionFn(string name, string password, Action ac = null) { ac?.Invoke((name + password).GetHashCode()); return Ok(); } ``` Request `/swagger/v1/swagger.json` The Action parameter can be ignored?