Swashbuckle and schemaId is already used
· 3 min read
Swashbuckle can fail to generate a swagger / Open API document with the message "The same schemaId is already used...". This post explains what that means, and offers a way to work around it.
4 posts tagged with "Swagger"
The Swagger API documentation framework - now known as OpenAPI.
View All TagsSwashbuckle & inheritance: Give. Me. The. Types
· 6 min read
For API endpoints that return multiple types, you can use inheritance with Swashbuckle to get create a Swagger / Open API definition featuring the variety of available types. Serving all these types is not the default behaviour. This post shows you how to opt in.
NSwag generated C# client: Open API property name clashes and decimal types rather than double
· 11 min read
NSwag is a great tool for generating client libraries in C# and TypeScript from Open API / Swagger definitions. You can face issues where Open API property names collide due to the nature of the C# language, and when you want to use decimal for your floating point numeric type over double. This post demonstrates how to get over both issues.
NSwag: TypeScript and CSharp client generation based on an API
· 9 min read
Generating clients for APIs is a tremendous way to reduce the amount of work you have to do when you're building a project. Why handwrite that code when it can be auto-generated for you quickly and accurately by a tool like NSwag? To quote the docs: