added xml comments for existing api parts and pieces.

This commit is contained in:
StevanFreeborn
2022-06-21 17:17:32 -05:00
parent 19729f4cc7
commit 5e201182ba
9 changed files with 149 additions and 14 deletions
@@ -0,0 +1,20 @@
using Microsoft.OpenApi.Any;
using Microsoft.OpenApi.Models;
using Swashbuckle.AspNetCore.SwaggerGen;
namespace server.Filters
{
public class ApiVersionOperationFilter : IOperationFilter
{
public void Apply(OpenApiOperation operation, OperationFilterContext context)
{
var headerParameter = operation.Parameters.Where(p => p.Name == "x-api-version").SingleOrDefault();
if (headerParameter != null)
{
headerParameter.Description = "Header value that identifies target version of api.";
headerParameter.Schema.Default = new OpenApiString(context.DocumentName.ToLower().Replace("v", ""));
}
}
}
}