mvkrishnas / restapi-versioning Goto Github PK

  Ex : https://localhost:44347/api/VersioningDemo?api-version=1.0

  Ex : https://localhost:44347/api/VersioningDemo add X-Version = 2.0 or accept = application/json;ver=2.0 in Header

  Ex: https://localhost:44347/api/V3/VersioningDemo (v3 is the uri version)

   API Versioning package allows us to flag APIs as deprecated. So this gives time to the client to prepare changes. Otherwise immediately deleting older APIs          could give a bad taste to clients.
   Ex [ApiVersion("1.0", Deprecated = true)] at controller level

•	Microsoft.Aspnetcore.Mvc.Versioning
•	Microsoft.AspNetCore.Mvc.Versioning.ApiExplorer

      services.AddApiVersioning(version =>
      {
          version.AssumeDefaultVersionWhenUnspecified = true;
          version.DefaultApiVersion = new Microsoft.AspNetCore.Mvc.ApiVersion(1, 0);
          version.ReportApiVersions = true;
          version.ApiVersionReader = ApiVersionReader.Combine(
                          new QueryStringApiVersionReader("api-version"),
                          new HeaderApiVersionReader("X-Version"),
                          new MediaTypeApiVersionReader("ver"));
      });
      services.AddVersionedApiExplorer(options =>
      {
          options.GroupNameFormat = "'v'VVV";
          options.SubstituteApiVersionInUrl = true;
      });