Swashbuckle.AspNetCore
Swashbuckle.AspNetCore copied to clipboard
Swagger tools for documenting API's built on ASP.NET Core
## Problem I have a POST method: ```c# public async Task Post([FromBody] Person newMember) ``` With the `Person` model being: ```c# public class Person { /// The name of the...
### Is your feature request related to a specific problem? Or an existing feature? When generating OpenAPI json in most cases it is desirable that non-nullable properties are marked as...
### Describe the bug Commentary on the models. The comment contains line breaks (\r\n) ```csharp /// Multi\r\nline text]]> public string Data { get; set; } ``` The swagger displays already...
I am facing an issue while trying to add a format attribute to each definition schema in my code using Swagger using Swashbuckle annotation `[SwaggerSchema(Format = nameof(...))]`. The value of...
Swashbuckle cli 6.5.0 Implementing request examples as: IExamplesProvider from Swashbuckle.AspNetCore.Filters Expect json to have an _example:_ section as per the following: https://github.com/mattfrear/Swashbuckle.AspNetCore.Filters?tab=readme-ov-file#request-example My swagger page json works correctly, the json...
Swashbuckle.AspNetCore: 6.5.0 .NET 7 I am not sure if this is a bug or a feature request. When defining APIs using the minimal API approach, the summaries from models are...
Currently the UniqueItems flag is only generated when the type is of type ISet, properties of type IReadOnlySet are not considered. https://github.com/domaindrivendev/Swashbuckle.AspNetCore/blob/c5094a3a373985632bcab5072c98175bc563e875/src/Swashbuckle.AspNetCore.SwaggerGen/SchemaGenerator/SchemaGenerator.cs#L303
Swashbuckle.AspNetCore 6.5.0 Swashbuckle.AspNetCore.Annotations 6.5.0. .Net 7 ### Goal I was trying to **model bind multiple sources to a single class** and ignore some parameters with `[SwaggerSchema(ReadOnly = true)]`. I thought...
I'm not completely sure if it's a bug, or it's like this by design, but it certainly feels strange to me. Say, I inject a parameter via a custom `ModelBinder`...
This is a minor change to add support for PathBase. In cases where the API needs to use app.UsePathBase("some/path"), getting Swagger UI to conform to this path with RoutePrefix was...