swashbuckle – Page 3

Bearer authentication in Swagger UI, when migrating to Swashbuckle.AspNetCore version 5

January 17, 2023 by Tarik

Got this working in the end by trial and error. This is the code that works for me: c.AddSecurityDefinition(“Bearer”, new OpenApiSecurityScheme { Description = “JWT Authorization header using the Bearer scheme. \r\n\r\n Enter ‘Bearer’ [space] and then your token in the text input below.\r\n\r\nExample: \”Bearer 12345abcdef\””, Name = “Authorization”, In = ParameterLocation.Header, Type = SecuritySchemeType.ApiKey, … Read more

Swagger not loading – Failed to load API definition: Fetch error undefined

January 14, 2023 by Tarik

So after a lot of troubleshooting it came down to basically two things, but I feel that in general this could be helpful to someone else in the future so I’m posting an answer. First- if ever your stuck with the aforementioned error the best way to actually see whats going on is by adding … Read more

swagger error: Conflicting schemaIds: Duplicate schemaIds detected for types A and B

January 7, 2023 by Tarik

Every class in the swagger JSON must have a unique schemaId. Swashbuckler tries to just use the class name as a simple schemaId, however if you have two classes in different namespaces with the same name (as you do) this will not work. As the error suggests, you can use the config setting “UseFullTypeNameInSchemaIds*” for … Read more

Swashbuckle/Swagger + ASP.Net Core: “Failed to load API definition”

January 1, 2023 by Tarik

Add Httpxxx([HttpGet], [HttpPost], …) attribute for each Action method, or [ApiExplorerSettings(IgnoreApi = true)]

ASP.NET Core – Swashbuckle not creating swagger.json file

December 31, 2022 by Tarik

I had the same problem. Check http://localhost:XXXX/swagger/v1/swagger.json. If you get any a errors, fix them. For example, I had an ambiguous route in a base controller class and I got the error: “Ambiguous HTTP method for action. Actions require an explicit HttpMethod binding for Swagger 2.0.”. If you use base controllers make sure your public … Read more

500 Error when setting up Swagger in asp .net CORE / MVC 6 app

December 2, 2022 by Tarik

If someone want to know the exact error is in the Swagger’s stack trace, request the URL: <your-app-url>/swagger/v1/swagger.json Or, click on the swagger.json link from the browser dev tools console: Which will show the error in your IDE Output:

Swagger UI Web Api documentation Present enums as strings?

October 13, 2022 by Tarik

Enable globally From the docs: httpConfiguration .EnableSwagger(c => { c.SingleApiVersion(“v1”, “A title for your API”); c.DescribeAllEnumsAsStrings(); // this will do the trick }); Enum/string conversion on particular property Also, if you want this behavior only on a particular type and property, use the StringEnumConverter: public class Letter { [Required] public string Content {get; set;} [Required] … Read more