aspnet-api-versioning VS Swashbuckle.AspNetCore

Compare aspnet-api-versioning vs Swashbuckle.AspNetCore and see what are their differences.

aspnet-api-versioning

Provides a set of libraries which add service API versioning to ASP.NET Web API, OData with ASP.NET Web API, and ASP.NET Core. (by dotnet)

Swashbuckle.AspNetCore

Swagger tools for documenting API's built on ASP.NET Core (by domaindrivendev)
Our great sponsors
  • InfluxDB - Power Real-Time Data Analytics at Scale
  • WorkOS - The modern identity platform for B2B SaaS
  • SaaSHub - Software Alternatives and Reviews
aspnet-api-versioning Swashbuckle.AspNetCore
12 15
2,931 5,047
0.6% -
8.6 0.0
about 2 months ago 9 days ago
C# C#
MIT License MIT License
The number of mentions indicates the total number of mentions that we've tracked plus the number of user suggested alternatives.
Stars - the number of stars that a project has on GitHub. Growth - month over month growth in stars.
Activity is a relative number indicating how actively a project is being developed. Recent commits have higher weight than older ones.
For example, an activity of 9.0 indicates that a project is amongst the top 10% of the most actively developed projects that we are tracking.

aspnet-api-versioning

Posts with mentions or reviews of aspnet-api-versioning. We have used some of these posts to build our list of alternatives and similar projects. The last one was on 2023-06-28.

Swashbuckle.AspNetCore

Posts with mentions or reviews of Swashbuckle.AspNetCore. We have used some of these posts to build our list of alternatives and similar projects. The last one was on 2023-06-24.
  • Advantages and disadvantages of FastEndpoints
    4 projects | /r/dotnet | 24 Jun 2023
    It isn't where it needs to be. Notably, it cannot out-of-the-box handle open generic data types. There's also plenty of issues logged for this library. - Personally, that makes me think the approach is overly complicated and doesn't do its job as well as it should.
  • Authenticate Next.js SPA with ASP.NET 6 Identity and Duende Identity Server Part 1
    2 projects | dev.to | 30 Mar 2022
    Swashbuckle Github repo
  • A Developer's Guide to CQRS Using .NET Core and MediatR
    3 projects | dev.to | 31 Aug 2021
    Swashbuckle Swagger
  • Organize code by concepts, not layers
    4 projects | /r/programming | 5 Jun 2021
    That’s exactly what I meant. There’s about 0 maintenance required most of the time. Take a look at their official nuget GitHub page. This should work out of the box with ASP.NET core 3.0 and greater. For 5.0 onwards, the MVC template comes pre-configured with it.
  • Auto Generate Client From OpenAPI Specification (Swagger)
    2 projects | dev.to | 6 Apr 2021
    When you run your web api app, you can access the swagger.json at http://localhost:/swagger/v1/swagger.json. Now either you can pass the link to swagger.json or make it accessible from file system. If you go the former route then you need to ensure your web api is up somewhere and updated or spin it up locally. I went ahead with downloading the file into file system using Swashbuckle.AspNetCore.Cli which can generate swagger.json from your web api assembly.
  • What every ASP.NET Core Web API project needs - Part 2 - API versioning and Swagger
    4 projects | dev.to | 1 Mar 2021
    /// /// Represents the Swagger/Swashbuckle operation filter used to document the implicit API version parameter. /// /// This is only required due to bugs in the . /// Once they are fixed and published, this class can be removed. public class SwaggerDefaultValues : IOperationFilter { /// /// Applies the filter to the specified operation using the given context. /// /// The operation to apply the filter to. /// The current operation filter context. public void Apply(OpenApiOperation operation, OperationFilterContext context) { var apiDescription = context.ApiDescription; operation.Deprecated |= apiDescription.IsDeprecated(); // REF: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/issues/1752#issue-663991077 foreach (var responseType in context.ApiDescription.SupportedResponseTypes) { // REF: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/blob/b7cf75e7905050305b115dd96640ddd6e74c7ac9/src/Swashbuckle.AspNetCore.SwaggerGen/SwaggerGenerator/SwaggerGenerator.cs#L383-L387 var responseKey = responseType.IsDefaultResponse ? "default" : responseType.StatusCode.ToString(); var response = operation.Responses[responseKey]; foreach (var contentType in response.Content.Keys) if (responseType.ApiResponseFormats.All(x => x.MediaType != contentType)) response.Content.Remove(contentType); } if (operation.Parameters == null) return; // REF: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/issues/412 // REF: https://github.com/domaindrivendev/Swashbuckle.AspNetCore/pull/413 foreach (var parameter in operation.Parameters) { var description = apiDescription.ParameterDescriptions.First(p => p.Name == parameter.Name); parameter.Description ??= description.ModelMetadata.Description; if (parameter.Schema.Default == null && description.DefaultValue != null) { // REF: https://github.com/Microsoft/aspnet-api-versioning/issues/429#issuecomment-605402330 var json = JsonSerializer.Serialize(description.DefaultValue, description.ModelMetadata.ModelType); parameter.Schema.Default = OpenApiAnyFactory.CreateFromJson(json); } parameter.Required |= description.IsRequired; } } }
  • .Net Framework için Swagger ve JWT Authentication
    2 projects | dev.to | 26 Dec 2020
    domaindrivendev/Swashbuckle.AspNetCore
  • AWS Systems Manager Parameter Store for Managing Configuration and Retrieve at Runtime using C#
    3 projects | dev.to | 27 Nov 2020
    Swashbuckle.AspNetCore.Swagger
  • ASP.NET Core API - Path Versioning
    2 projects | dev.to | 1 Nov 2020
    Now we'll focus on getting versioning working with Swagger Generation and Swashbuckle.

What are some alternatives?

When comparing aspnet-api-versioning and Swashbuckle.AspNetCore you can also consider the following projects:

swagger-core - Examples and server integrations for generating the Swagger API Specification, which enables easy access to your REST API

api-guidelines - Microsoft REST API Guidelines

SPA-Identity-Server-Authenticate-Sample - SPA Identity Server Authenticate Sample

CleanArchitecture - Clean Architecture Solution Template for ASP.NET Core

swagger-petstore - swagger-codegen contains a template-driven engine to generate documentation, API clients and server stubs in different languages by parsing your OpenAPI / Swagger definition.

opentelemetry-specification - Specifications for OpenTelemetry

cqrs-with-net-core-mediatr

SpaceEmporium - Simple API Versioning in ASP.NET Core

MediatR - Simple, unambitious mediator implementation in .NET

CleanArchitectureApp - Clean Architecture Application Design from Scratch using Dotnet Core 5 WebApi and Angular 11 FrontEnd

ApiVersioningSwagger - Api Versioning Swagger example